Please remember that an important goal of these accomplishments is that the documentation should be detailed: think of it as a wikipedia for how to get started with a particular Ask Ubuntu badge.
To write an accomplishment file do this:
bzr branch lp:ubuntu-community-accomplishments
cd ubuntu-community-accomplishments/accomplishments/ubuntu-community/en/support
In there you should see a bunch of .accomplishment files, each corresponding to a badge. Open it up, it should look like this:
[accomplishment]
title=Altruist on Ask Ubuntu
description=First bounty you manually awarded on another person's question
collection=ubuntu-community
category=Ask Ubuntu:Bounty
icon=askubuntu-gold.png
needs-signing=true
needs-information=askubuntu-user-url
summary = Explain here in detail what this badge is, and what is involved is accomplishing it.
steps: Provide step by step instructions for to accomplish this.
Each step should be on a new line with a tab at the beginning, like this.
links: http://www.askubuntu.com
tips: Things and recommendations that people might find useful in earning the accomplishment.
pitfalls: Provide tips to avoid
So users can learn
help = #ubuntu-community-team on Freenode
author = Jorge Castro <[email protected]>
You only need to fix up icon, steps, tips, pitfalls, and author, you can leave the rest alone.
- category - The format is
category=Ask Ubuntu:subcategory
. For the list of subcategories, use this meta post. - icon - for the icons, use use the same icon as used by Ask Ubuntu (e.g. if it is Gold on Ask Ubuntu, ensure it has the gold icon in Ubuntu Accomplishments. You can use the following filenames:
askubuntu-gold.png
,askubuntu-silver.png
, andaskubuntu-bronze.png
for the icons corresponding to each badge. - summary - this should be a detailed description of the badge and what is involved. For example if you are talking about your profile, explain what a profile is, why the user should care, and how they access it. To start a new paragraph, start a new line and put a tab at the beginning.
- steps - add a series of chrononological steps for how to accomplish the badge. To add a new step, start a new line and put a tab at the beginning.
- tips - add a series of tips that can help someone be successful in accomplishing the badge. To add a new tip, start a new line and put a tab at the beginning.
- pitfalls - add a series of things the user should not do. To add a new pitfall, start a new line and put a tab at the beginning.
Save your file, and then submit it by doing:
bzr commit
And then add a changelog entry, something like "Added the yearling badge", then save and push:
bzr push lp:~yourlaunchpadusername/ubuntu-community-accomplishments/give-your-branch-a-cool-name-here
Now open your branch in your browser:
bzr lp-open
And then click on "Propose for merging" and then add a decription, paste in lp:ubuntu-community-accomplishments
for the branch you want to propose into and click "Submit".
Tips:
- You can remove the tag description that says "This badge can be earned multiple times" as the Ubuntu system only awards for the first time.
- All the descriptions are on the badge page so you can copy and paste those.
Once you've submitted the accomplishment file cross it off this list.
Altruist- MarcoAnalytical- MarcoAnnouncer- MarcoArchaeologist- MarcoAutobiographer- MarcoBenefactor- MarcoBeta- MarcoBooster- MarcoCitizen Patrol- MarcoCivic Duty- MarcoCleanup- MarcoCommentator- MarcoConvention- MarcoCopy Editor- MarcoCritic- Agmenor- Deputy - Marco
- Disciplined - Marco
- Editor - Marco
- Electorate - Marco
- Enlightened - Marco
- Enthusiast - Marco
- Epic - Marco
- Excavator - Marco
Famous Question- htorqueFanatic- WarriorIng64Favorite Question- htorque- Generalist
Good Answer- George EdisonGood Question- htorqueGreat Answer- jorgeGreat Question- jorge- Guru
- Investor
- Legendary
- Marshal
- Mortarboard
- Necromancer
Nice Answer- htorqueNice Question- htorqueNotable Question- htorque- Organizer
- Outspoken
Peer Pressure- htorquePopular Question- htorquePopulist- htorquePrecognitive- htorquePromoter- htorque- Proofreader
Publicist- htorquePundit- htorqueQuorum- htorque- Research Assistant
- Reversal
- Reviewer
- Revival
- Scholar
Self-Learner- surgemcgeeSportsmanship- surgemcgeeStellar Question- surgemcgeeStrunk & White- surgemcgee- Student - WarriorIng64
- Suffrage - WarriorIng64
- Supporter
- Synonymizer
Tag Editor- jorge- Talkative - jorge
Taxonomist- jorge- Teacher - jorge
Tenacious- jorgeTumbleweed- jorgeUnsung Hero- jorgeVox Populi- jorgeYearling- jorge