Editing AI Ideas Knowledge Base:Editorial Style Guide

{{DISPLAYTITLE:AI Ideas Knowledge Base: Editorial Style Guide}}
__TOC__

= 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:'''
<pre>
{{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]]
</pre>

==== 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 ==

=== {{Idea}} 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:'''
<pre>
{{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
}}
</pre>

=== {{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

=== {{Quote}} Template ===

For highlighting significant quotes or insights.

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

== Citation and Reference Standards ==

=== In-Text Citations ===

Use numbered references with the &lt;ref&gt; tag system:

<pre>
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...
</pre>

=== Reference Formatting ===

Follow academic citation standards appropriate to the source type:

'''Books:'''
<pre>
Author, A. A. (Year). ''Title of book''. Publisher.
</pre>

'''Journal Articles:'''
<pre>
Author, A. A. (Year). Title of article. ''Journal Name'', Volume(Issue), pages.
</pre>

'''Web Sources:'''
<pre>
Author, A. A. (Year, Month Day). Title of web page. ''Website Name''. URL
</pre>

'''Conference Papers:'''
<pre>
Author, A. A. (Year). Title of paper. In ''Proceedings of Conference Name'' (pp. pages). Publisher.
</pre>

=== 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 ===

* '''[[Category:AI Theory]]''' - Theoretical foundations and concepts
* '''[[Category:Machine Learning]]''' - Learning algorithms and methodologies
* '''[[Category:Cognitive Science]]''' - Human cognition and AI parallels
* '''[[Category:Computer Science]]''' - Technical implementation aspects
* '''[[Category:Philosophy of Mind]]''' - Consciousness, intelligence, and cognition
* '''[[Category:Economics]]''' - Economic implications and theories
* '''[[Category:Ethics]]''' - Moral and ethical considerations
* '''[[Category:History of AI]]''' - Historical development and milestones
* '''[[Category:Futurism]]''' - Predictions and speculative developments
* '''[[Category:Robotics]]''' - Physical AI implementations

=== Secondary Categories ===

* '''[[Category:Researchers]]''' - Individual contributors to the field
* '''[[Category:Institutions]]''' - Organizations and research centers
* '''[[Category:Publications]]''' - Significant books, papers, and journals
* '''[[Category:Technologies]]''' - Specific tools and implementations
* '''[[Category:Applications]]''' - 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:'''
<pre>
[[Page Title]]
[[Page Title|Display Text]]
</pre>

'''Section Links:'''
<pre>
[[Page Title#Section Name]]
[[Page Title#Section Name|Display Text]]
</pre>

'''Category Links:'''
<pre>
[[:Category:Category Name]]
</pre>

=== 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 ===

# '''Topic Selection:''' Identify gaps in current coverage
# '''Source Gathering:''' Compile authoritative references
# '''Scope Definition:''' Determine article boundaries and depth
# '''Structure Planning:''' Outline major sections and flow

=== Development Phase ===

# '''Draft Creation:''' Initial content development
# '''Template Integration:''' Apply appropriate templates
# '''Internal Linking:''' Connect to existing content
# '''Citation Addition:''' Include proper references

=== Review Phase ===

# '''Content Review:''' Accuracy and completeness check
# '''Style Review:''' Adherence to guidelines
# '''Technical Review:''' Markup and formatting verification
# '''Final Polish:''' Grammar, spelling, and flow refinement

=== Publication Phase ===

# '''Category Assignment:''' Apply appropriate classifications
# '''Link Integration:''' Ensure bidirectional connectivity
# '''Announcement:''' Notify relevant contributor communities
# '''Monitoring:''' Track usage and feedback

== Technical Implementation Notes ==

=== MediaWiki Markup Essentials ===

'''Text Formatting:'''
<pre>
''italics''
'''bold'''
'''''bold italics'''''
</pre>

'''Headers:'''
<pre>
= Level 1 =
== Level 2 ==
=== Level 3 ===
==== Level 4 ====
</pre>

'''Lists:'''
<pre>
* Unordered item
* Another item
** Sub-item

# Ordered item
# Another item
## Sub-item
</pre>

'''Tables:'''
<pre>
{| class="wikitable"
|-
! Header 1 !! Header 2
|-
| Cell 1 || Cell 2
|-
| Cell 3 || Cell 4
|}
</pre>

=== Advanced Formatting ===

'''Information Boxes:'''
<pre>
{| class="infobox"
|-
| '''Field Name:''' || Field Value
|-
| '''Another Field:''' || Another Value
|}
</pre>

'''Code Blocks:'''
<pre>
&lt;syntaxhighlight lang="python"&gt;
def example_function():
    return "Hello, World!"
&lt;/syntaxhighlight&gt;
</pre>

'''Mathematical Notation:'''
<pre>
&lt;math&gt;E = mc^2&lt;/math&gt;
</pre>

=== 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]]
* [[Category:Editorial Guidelines]]

== External Links ==

* [https://www.mediawiki.org/wiki/Help:Formatting MediaWiki Formatting Help]
* [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Wikipedia Manual of Style]
* [https://www.chicagomanualofstyle.org/ Chicago Manual of Style Online]

== References ==

&lt;references /&gt;

[[Category:Editorial Guidelines]]
[[Category:Knowledge Base Administration]]
[[Category:Style Guides]]
[[Category:MediaWiki Documentation]]

__NOTOC__