ZelocoreCMS:Contributing: Difference between revisions
Appearance
Contributing guide ย |
v2.0: Three-track onboarding, step-by-step guide, template gallery ย |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
= How to Contribute = | = โ๏ธ How to Contribute to ZelocoreCMS Wiki = | ||
ย | |||
<div style="background:linear-gradient(90deg,#dcfce7,#f0fdf4);border:1px solid #059669;border-radius:8px;padding:12px 18px;margin-bottom:18px;"> | |||
'''Anyone can contribute''' โ you don't need to be a developer or expert. If you know something about a CMS platform that isn't documented here, your knowledge belongs on this wiki. | |||
</div> | |||
ย | |||
== ๐ Choose Your Track == | |||
ย | |||
<div style="display:flex;flex-wrap:wrap;gap:12px;margin-bottom:20px;"> | |||
<div style="flex:1 1 28%;min-width:200px;background:linear-gradient(135deg,#dcfce7,#f0fdf4);border:1px solid #059669;border-radius:8px;padding:14px;"> | |||
=== ๐ฑ Newcomer === | |||
''First time here?'' | |||
# [[Special:CreateAccount|Create an account]] | # [[Special:CreateAccount|Create an account]] | ||
# Read the [[ZelocoreCMS: | # Read this guide fully | ||
# Browse [[Special: | # Try the [[Special:Sandbox|sandbox]] | ||
# Fix a typo in any article | |||
# Add a missing sentence | |||
</div> | |||
<div style="flex:1 1 28%;min-width:200px;background:linear-gradient(135deg,#dbeafe,#eff6ff);border:1px solid #2563eb;border-radius:8px;padding:14px;"> | |||
=== โ๏ธ Regular Editor === | |||
''Ready for more?'' | |||
ย | |||
# Write a full CMS article | |||
# Expand a [[Category:Stub_articles|stub article]] | |||
# Add code examples | |||
# Add an infobox | |||
# Tag articles with categories | |||
</div> | |||
<div style="flex:1 1 28%;min-width:200px;background:linear-gradient(135deg,#ede9fe,#f5f3ff);border:1px solid #7c3aed;border-radius:8px;padding:14px;"> | |||
=== โก Advanced === | |||
''Power user?'' | |||
ย | |||
# Create new [[Help:Templates|templates]] | |||
# Write comparison tables | |||
# Mentor newcomers | |||
# [[ZelocoreCMS:Claim|Claim your CMS page]] | |||
# Review articles for quality | |||
</div> | |||
</div> | |||
ย | |||
== ๐ Step-by-Step: Your First Edit == | |||
ย | |||
; Step 1 โ Create an account | |||
: [[Special:CreateAccount|Register here]]. Editing without an account is limited and your edits are tracked by IP address. | |||
ย | |||
; Step 2 โ Find something to improve | |||
: Browse [[Special:Random|a random article]], check [[Category:Stub_articles|stub articles]], or pick a task from the [[ZelocoreCMS:Community_Portal#Active_Task_Board|Community Portal task board]]. | |||
ย | |||
; Step 3 โ Click "Edit" or "Edit source" | |||
: Use the '''VisualEditor''' (Edit) for a word-processor-like experience, or '''Edit source''' for direct wikitext editing. | |||
ย | |||
; Step 4 โ Make your changes | |||
: Keep it factual, neutral, and follow the [[ZelocoreCMS:Style_Guide|style guide]]. | |||
ย | |||
; Step 5 โ Write an edit summary | |||
: Describe what you changed in the summary box (e.g., "Added installation section"). This helps other editors understand your changes. | |||
ย | |||
; Step 6 โ Save! | |||
: Click "Publish changes". Your edit is live immediately. | |||
ย | |||
== โ
What Makes a Good Article? == | |||
ย | |||
A good CMS article on ZelocoreCMS Wiki covers: | |||
{| class="wikitable" style="width:100%;" | |||
! Section !! What to include | |||
|- | |||
| '''Lead paragraph''' || One sentence defining the platform and its primary use case | |||
|- | |||
| '''Infobox''' || Use <code><nowiki>{{CMS_Infobox}}</nowiki></code> โ developer, license, language, website | |||
|- | |||
| '''Overview''' || 2-3 paragraphs: what it is, who uses it, key strengths | |||
|- | |||
| '''Key Features''' || Bullet list of distinguishing features | |||
|- | |||
| '''Installation''' || Step-by-step setup with code examples | |||
|- | |||
| '''API Reference''' || REST/GraphQL endpoints, authentication, examples | |||
|- | |||
| '''Pricing''' || Free tier? Paid plans? Open source? | |||
|- | |||
| '''Pros & Cons''' || Neutral comparison table | |||
|- | |||
| '''See Also''' || Links to related platforms and categories | |||
|- | |||
| '''External Links''' || Official docs, GitHub, community forum | |||
|} | |||
ย | |||
== ๐จ Using Templates == | |||
ย | |||
Templates make articles consistent and beautiful. Here are the key ones: | |||
ย | |||
{| class="wikitable" style="width:100%;font-size:.92em;" | |||
! Template !! Purpose !! Example | |||
|- | |||
| <code><nowiki>{{CMS_Infobox}}</nowiki></code> || Right-side info panel || [[Template:CMS_Infobox|View template]] | |||
|- | |||
| <code><nowiki>{{Note|text}}</nowiki></code> || Blue info callout || [[Template:Note|View template]] | |||
|- | |||
| <code><nowiki>{{Warning|text}}</nowiki></code> || Orange warning callout || [[Template:Warning|View template]] | |||
|- | |||
| <code><nowiki>{{Tip|text}}</nowiki></code> || Green tip callout || [[Template:Tip|View template]] | |||
|- | |||
| <code><nowiki>{{Stub}}</nowiki></code> || Marks article as incomplete || [[Template:Stub|View template]] | |||
|- | |||
| <code><nowiki>{{Official_Page|company=X}}</nowiki></code> || Official maintainer badge || [[Template:Official_Page|View template]] | |||
|- | |||
| <code><nowiki>{{Under_Construction}}</nowiki></code> || Work-in-progress notice || [[Template:Under_Construction|View template]] | |||
|} | |||
ย | |||
== ๐ Creating a New CMS Article == | |||
ย | |||
Use this box to instantly start a pre-formatted draft: | |||
ย | |||
<inputbox> | |||
type=create | |||
placeholder=Enter the CMS platform name... | |||
width=40 | |||
buttonlabel=๐ Create Pre-formatted Draft | |||
preload=Template:New_CMS_Draft | |||
</inputbox> | |||
ย | |||
The draft will be pre-filled with all required sections, the infobox, and correct categories. Just fill in the blanks! | |||
ย | |||
== โ Common Mistakes to Avoid == | |||
ย | |||
{{Warning|These are the most common reasons edits get reverted.}} | |||
ย | |||
* '''Marketing language''' โ Do not write "the best", "revolutionary", "industry-leading". Keep it factual. | |||
* '''Unsourced claims''' โ Always link to official documentation for facts about features or pricing. | |||
* '''Wrong categories''' โ Check the [[ZelocoreCMS:Style_Guide#Categories|style guide category section]] before saving. | |||
* '''Missing infobox''' โ Every CMS article needs a <code><nowiki>{{CMS_Infobox}}</nowiki></code>. | |||
* '''No edit summary''' โ Always fill in the edit summary box. | |||
ย | |||
== ๐งช Practice First == | |||
ย | |||
Not sure? Use the [[Special:Sandbox|sandbox page]] to experiment with wikitext and templates without any risk. Changes to the sandbox are not permanent. | |||
ย | |||
== ๐ Getting Help == | |||
* Post on the [[ZelocoreCMS:Community_Portal|Community Portal]] | |||
* | * Ask on any article's [[Help:Talk_pages|talk page]] | ||
* ' | * Request a mentor on your own [[Special:MyTalk|user talk page]] | ||
* | * Contact an [[Special:ListAdmins|administrator]] | ||
* | |||
[[Category:ZelocoreCMS]] | |||
Latest revision as of 22:03, 29 July 2026
โ๏ธ How to Contribute to ZelocoreCMS Wiki
Anyone can contribute โ you don't need to be a developer or expert. If you know something about a CMS platform that isn't documented here, your knowledge belongs on this wiki.
๐ Choose Your Track
๐ฑ Newcomer
First time here?
- Create an account
- Read this guide fully
- Try the sandbox
- Fix a typo in any article
- Add a missing sentence
โ๏ธ Regular Editor
Ready for more?
- Write a full CMS article
- Expand a
- Add code examples
- Add an infobox
- Tag articles with categories
โก Advanced
Power user?
- Create new templates
- Write comparison tables
- Mentor newcomers
- Claim your CMS page
- Review articles for quality
๐ Step-by-Step: Your First Edit
- Step 1 โ Create an account
- Register here. Editing without an account is limited and your edits are tracked by IP address.
- Step 2 โ Find something to improve
- Browse a random article, check , or pick a task from the Community Portal task board.
- Step 3 โ Click "Edit" or "Edit source"
- Use the VisualEditor (Edit) for a word-processor-like experience, or Edit source for direct wikitext editing.
- Step 4 โ Make your changes
- Keep it factual, neutral, and follow the style guide.
- Step 5 โ Write an edit summary
- Describe what you changed in the summary box (e.g., "Added installation section"). This helps other editors understand your changes.
- Step 6 โ Save!
- Click "Publish changes". Your edit is live immediately.
โ What Makes a Good Article?
A good CMS article on ZelocoreCMS Wiki covers:
| Section | What to include |
|---|---|
| Lead paragraph | One sentence defining the platform and its primary use case |
| Infobox | Use {{CMS_Infobox}} โ developer, license, language, website
|
| Overview | 2-3 paragraphs: what it is, who uses it, key strengths |
| Key Features | Bullet list of distinguishing features |
| Installation | Step-by-step setup with code examples |
| API Reference | REST/GraphQL endpoints, authentication, examples |
| Pricing | Free tier? Paid plans? Open source? |
| Pros & Cons | Neutral comparison table |
| See Also | Links to related platforms and categories |
| External Links | Official docs, GitHub, community forum |
๐จ Using Templates
Templates make articles consistent and beautiful. Here are the key ones:
| Template | Purpose | Example |
|---|---|---|
{{CMS_Infobox}} |
Right-side info panel | View template |
{{Note|text}} |
Blue info callout | View template |
{{Warning|text}} |
Orange warning callout | View template |
{{Tip|text}} |
Green tip callout | View template |
{{Stub}} |
Marks article as incomplete | View template |
{{Official_Page|company=X}} |
Official maintainer badge | View template |
{{Under_Construction}} |
Work-in-progress notice | View template |
๐ Creating a New CMS Article
Use this box to instantly start a pre-formatted draft:
The draft will be pre-filled with all required sections, the infobox, and correct categories. Just fill in the blanks!
โ Common Mistakes to Avoid
โ ๏ธ These are the most common reasons edits get reverted.
- Marketing language โ Do not write "the best", "revolutionary", "industry-leading". Keep it factual.
- Unsourced claims โ Always link to official documentation for facts about features or pricing.
- Wrong categories โ Check the style guide category section before saving.
- Missing infobox โ Every CMS article needs a
{{CMS_Infobox}}. - No edit summary โ Always fill in the edit summary box.
๐งช Practice First
Not sure? Use the sandbox page to experiment with wikitext and templates without any risk. Changes to the sandbox are not permanent.
๐ Getting Help
- Post on the Community Portal
- Ask on any article's talk page
- Request a mentor on your own user talk page
- Contact an administrator