AI Ideas Knowledge Base:Editorial Style Guide

AI Ideas Knowledge Base: Editorial Style Guide

This comprehensive guide establishes the editorial standards and organizational principles for creating high-quality content on the AI Ideas Knowledge Base at ai.specify.com. All contributors should follow these guidelines to ensure consistency, quality, and professional presentation across all content.

Content Organization Standards

Page Type Hierarchy

The Knowledge Base uses a structured namespace system to organize different types of content:

Idea: Pages

Purpose: Core conceptual entries that explore specific AI-related ideas, theories, or phenomena.

Structure:

• Lead Section: Clear, concise definition and overview (1-2 paragraphs)
• Detailed Description: In-depth exploration of the concept
• Historical Context: Origins and development of the idea
• Key Contributors: Notable figures who developed or advanced the concept
• Related Concepts: Cross-references to connected ideas
• Applications: Real-world implementations or implications
• Criticisms and Limitations: Balanced perspective on challenges
• Further Reading: External resources and references

Example Structure:

{{Idea
|title=Artificial General Intelligence
|category=AI Theory
|contributors=John McCarthy, Marvin Minsky
|related=Machine Learning, Cognitive Computing
}}

'''Artificial General Intelligence''' (AGI) refers to...

== Definition and Scope ==

== Historical Development ==

== Key Contributors ==

== Technical Foundations ==

== Current Research ==

== Philosophical Implications ==

== Challenges and Limitations ==

== See Also ==

== References ==

[[Category:AI Theory]]
[[Category:Cognitive Science]]

Topic: Pages

Purpose: Broader subject areas that encompass multiple related ideas and concepts.

Structure:

• Overview: Comprehensive introduction to the topic area
• Subtopics: Organized breakdown of constituent ideas
• Historical Timeline: Evolution of the field
• Major Figures: Key researchers and thought leaders
• Current State: Present developments and research directions
• Future Prospects: Anticipated developments

Economist: Pages

Purpose: Biographical and analytical profiles of economists whose work intersects with AI development.

Structure:

• Biography: Professional background and career highlights
• Key Contributions: Major theories, publications, and ideas
• AI Relevance: Connection to artificial intelligence research
• Notable Works: Important publications with brief descriptions
• Influence and Legacy: Impact on the field
• Quotes and Insights: Representative thoughts and perspectives

Visionary: Pages

Purpose: Profiles of forward-thinking individuals who have shaped AI discourse and development.

Structure:

• Background: Personal and professional history
• Vision: Core beliefs about AI's future and impact
• Contributions: Practical and theoretical contributions to AI
• Public Engagement: Media appearances, writings, advocacy
• Controversies: Balanced coverage of debates or criticisms
• Selected Works: Key publications, speeches, or projects

Page Naming Conventions

• Idea Pages: Use descriptive, precise titles: "Machine Learning" not "ML"
• Person Pages: Use full names: "Alan Turing" not "A. Turing"
• Topic Pages: Use broad, inclusive terms: "Natural Language Processing" not "NLP Systems"
• Avoid: Abbreviations, jargon, or overly technical terms in titles
• Capitalization: Follow standard title case conventions

Template Usage Guidelines

===

Type: | Created: | ID: {{#if:|Confidence: {{{confidence}}}%|}}

Template ===

The primary template for Idea: pages provides structured metadata and consistent formatting.

Required Parameters:

• title: Full, formal name of the concept
• category: Primary classification (see Category System)

Optional Parameters:

• contributors: Key figures who developed the idea (comma-separated)
• related: Directly connected concepts (comma-separated)
• year: Year of initial development or publication
• field: Academic or research domain
• applications: Primary use cases or implementations

Usage Example:

{{Idea
|title=Deep Learning
|category=Machine Learning
|contributors=Geoffrey Hinton, Yann LeCun, Yoshua Bengio
|related=Neural Networks, Artificial Neural Networks, Backpropagation
|year=2006
|field=Computer Science
|applications=Computer Vision, Natural Language Processing, Speech Recognition
}}

Template:Person Template

For Economist: and Visionary: pages, providing biographical structure.

Parameters:

• name: Full name
• born: Birth year or date
• died: Death year or date (if applicable)
• nationality: Country of origin or primary affiliation
• field: Primary area of expertise
• known_for: Major contributions or theories
• institutions: Key affiliated organizations

Template:Quote Template

For highlighting significant quotes or insights.

Usage:

{{Quote
|text=The question is not whether machines can think, but whether men do.
|author=B.F. Skinner
|source=Contingencies of Reinforcement
|year=1969
}}

Citation and Reference Standards

In-Text Citations

Use numbered references with the <ref> tag system:

According to Turing's seminal paper,<ref>Turing, A. M. (1950). "Computing Machinery and Intelligence". ''Mind'', 59(236), 433-460.</ref> the question of machine intelligence...

Reference Formatting

Follow academic citation standards appropriate to the source type:

Books:

Author, A. A. (Year). ''Title of book''. Publisher.

Journal Articles:

Author, A. A. (Year). Title of article. ''Journal Name'', Volume(Issue), pages.

Web Sources:

Author, A. A. (Year, Month Day). Title of web page. ''Website Name''. URL

Conference Papers:

Author, A. A. (Year). Title of paper. In ''Proceedings of Conference Name'' (pp. pages). Publisher.

External Links

• Use sparingly and only for authoritative sources
• Prefer academic publications, institutional websites, and recognized media outlets
• Format: [URL Display Text]
• Include access dates for web sources

Category System Guidelines

Primary Categories

• ' - Theoretical foundations and concepts
• ' - Learning algorithms and methodologies
• ' - Human cognition and AI parallels
• ' - Technical implementation aspects
• ' - Consciousness, intelligence, and cognition
• ' - Economic implications and theories
• ' - Moral and ethical considerations
• ' - Historical development and milestones
• ' - Predictions and speculative developments
• ' - Physical AI implementations

Secondary Categories

• ' - Individual contributors to the field
• ' - Organizations and research centers
• ' - Significant books, papers, and journals
• ' - Specific tools and implementations
• ' - Practical uses and deployments

Category Application Rules

• Primary Rule: Every page must have at least one primary category
• Maximum: No more than 5 categories per page to avoid over-categorization
• Specificity: Choose the most specific applicable categories
• Hierarchy: Understand parent-child category relationships
• Consistency: Follow established categorization patterns

Internal Linking Best Practices

Strategic Cross-Referencing

• First Mention Rule: Link the first occurrence of related concepts
• Relevance: Only link terms directly relevant to the current topic
• Balance: Aim for 3-7 internal links per page section
• Avoid: Over-linking common terms or excessive blue text

Link Formatting

Standard Links:

[[Page Title]]
[[Page Title|Display Text]]

Section Links:

[[Page Title#Section Name]]
[[Page Title#Section Name|Display Text]]

Category Links:

[[:Category:Category Name]]

Navigation Patterns

• See Also Sections: Include 3-6 closely related pages
• Disambiguation: Clear linking when terms have multiple meanings
• Bidirectional: Ensure important pages link to each other appropriately
• Hierarchical: Link from specific to general concepts and vice versa

Writing Style Guidelines

Tone and Voice

• Neutral Point of View: Present information objectively
• Academic Rigor: Scholarly but accessible language
• Authoritative: Confident presentation of established facts
• Balanced: Include multiple perspectives on controversial topics
• Clear: Avoid unnecessarily complex jargon or terminology

Language Standards

• Third Person: Use objective, third-person perspective throughout
• Present Tense: For current states and ongoing research
• Past Tense: For historical events and completed research
• Active Voice: Prefer active construction when possible
• Precision: Use specific, accurate terminology

Formatting Conventions

• Bold: For the article title in the first sentence and key terms
• Italics: For publication titles, foreign terms, and emphasis
• Code formatting: For technical specifications and algorithms
• Lists: For organizing information clearly
• Headers: For logical section organization

Content Depth

• Comprehensive: Cover topics thoroughly within scope
• Proportional: Allocate space based on importance
• Current: Include recent developments and research
• Historical: Provide appropriate historical context
• Global: Consider international perspectives and developments

Quality Assurance Standards

Pre-Publication Checklist

Content Quality:

• [ ] Accurate and up-to-date information
• [ ] Proper citations for all claims
• [ ] Balanced presentation of controversial topics
• [ ] Clear, logical organization
• [ ] Appropriate depth and scope

Technical Standards:

• [ ] Correct MediaWiki markup
• [ ] Functional internal and external links
• [ ] Appropriate template usage
• [ ] Proper categorization
• [ ] Grammar and spelling accuracy

Navigation:

• [ ] Clear section headers
• [ ] Table of contents (for longer articles)
• [ ] "See Also" section with relevant links
• [ ] Category assignments

Peer Review Process

• Self-Review: Author completes initial quality check
• Content Review: Subject matter expert evaluates accuracy
• Editorial Review: Style and organization assessment
• Final Review: Comprehensive check before publication

Maintenance Standards

• Currency: Regular updates to reflect new developments
• Link Maintenance: Periodic checking of external links
• Category Updates: Adjustments as taxonomy evolves
• Content Expansion: Adding new sections as topics develop

Collaborative Editing Guidelines

Building Upon Existing Content

• Respect Original Structure: Maintain established organization
• Incremental Improvements: Make focused, specific enhancements
• Attribution: Acknowledge previous contributors appropriately
• Consistency: Match existing style and formatting
• Communication: Use discussion pages for major changes

Edit Summary Standards

• Descriptive: Clearly explain what was changed
• Specific: Focus on particular improvements made
• Concise: Keep summaries brief but informative
• Professional: Use neutral, objective language

Examples:

• "Added section on recent developments in transformer models"
• "Updated citation format to match style guide"
• "Corrected factual error in historical timeline"
• "Enhanced cross-references to related concepts"

Conflict Resolution

• Discussion First: Use talk pages to resolve disagreements
• Evidence-Based: Support positions with reliable sources
• Compromise: Seek balanced solutions when possible
• Escalation: Involve administrators for persistent conflicts

Content Development Process

Research Phase

1. Topic Selection: Identify gaps in current coverage
2. Source Gathering: Compile authoritative references
3. Scope Definition: Determine article boundaries and depth
4. Structure Planning: Outline major sections and flow

Development Phase

1. Draft Creation: Initial content development
2. Template Integration: Apply appropriate templates
3. Internal Linking: Connect to existing content
4. Citation Addition: Include proper references

Review Phase

1. Content Review: Accuracy and completeness check
2. Style Review: Adherence to guidelines
3. Technical Review: Markup and formatting verification
4. Final Polish: Grammar, spelling, and flow refinement

Publication Phase

1. Category Assignment: Apply appropriate classifications
2. Link Integration: Ensure bidirectional connectivity
3. Announcement: Notify relevant contributor communities
4. Monitoring: Track usage and feedback

Technical Implementation Notes

MediaWiki Markup Essentials

Text Formatting:

''italics''
'''bold'''
'''''bold italics'''''

Headers:

= Level 1 =
== Level 2 ==
=== Level 3 ===
==== Level 4 ====

Lists:

* Unordered item
* Another item
** Sub-item

# Ordered item
# Another item
## Sub-item

Tables:

{| class="wikitable"
|-
! Header 1 !! Header 2
|-
| Cell 1 || Cell 2
|-
| Cell 3 || Cell 4
|}

Advanced Formatting

Information Boxes:

{| class="infobox"
|-
| '''Field Name:''' || Field Value
|-
| '''Another Field:''' || Another Value
|}

Code Blocks:

<syntaxhighlight lang="python">
def example_function():
    return "Hello, World!"
</syntaxhighlight>

Mathematical Notation:

<math>E = mc^2</math>

Performance Considerations

• Image Optimization: Use appropriate file sizes and formats
• Link Economy: Balance connectivity with page load speed
• Template Efficiency: Avoid nested template complexity
• Category Moderation: Prevent category proliferation

Appendices

A. Template Reference

Complete documentation of available templates and their parameters.

B. Category Hierarchy

Visual representation of the category system and relationships.

C. Style Examples

Sample pages demonstrating proper formatting and organization.

D. Common Errors

Frequent mistakes and how to avoid them.

E. Resource Links

External resources for research and fact-checking.

See Also

• Help:Editing
• AI Ideas Knowledge Base:About
• AI Ideas Knowledge Base:Community Standards
• Template:Idea

External Links

• MediaWiki Formatting Help
• Wikipedia Manual of Style
• Chicago Manual of Style Online

References

<references />