97 Things Every Agile Software Developer Should Know
Rmonson (Talk | contribs)
(New page: Create an Account by clicking [http://commons.oreilly.com/wiki/index.php?title=Special:Userlogin&returnto=Special:Userlogout create_account]. You don't need an email invite to create an a...)
Next diff →
Revision as of 19:57, 24 September 2008
Create an Account by clicking create_account. You don't need an email invite to create an account.
This is the (provisional) home page for developing 97 Things Every Agile Software Developer Should Know.
Note: Before the site is made public we will be moving it from a wiki to a much more polished presentation created by professional web designers - this wiki is only an interim solution.
97 Things is a book of wisdom collected from leading Agile software developers - software developers that actually do Agile in real life. When we have a suitable number of things, we'll open it to the public for comment. When we've reached some still-undetermined magic number, we may publish it as a book taking the best 97 contributions.
What will come of all this?
O'Reilly will publish the contents of this wiki in a public and free web site off of the O'Reilly properties once it has a couple dozen entries. It will be embodied in a framework that based on Media Wiki, anyone can contribute, but includes addition features like voting and comments. It will be free to everyone but you'll have to register to contribute or comment or vote. Users (that's everyone who is registered) will be able to comment on other peoples axioms, rate other people's axioms, tag axioms, and create, edit and improve their own axioms. Anyone and everyone be able to view the material without requiring registration. The web site will be strongly promoted by O'Reilly and all contributers will get full attribution.
If the web site is a big success, O'Reilly will create a book from the web site. From the 97 Things web site O'Reilly and Luke Hohmann will pick the top contributions and create book edited by Luke Hohmann which it will sell in bookstores and on-line. If your contribution is chosen any edits recommended by O'Reilly will be contributed back to the 97 Things web site for everyone to enjoy. Every contributer whose contribution goes into the book will get a complementary copy of the book when its published.
To get a feel for this type of project take a look at another book in the series called 97 Things Every Software Architect Should Know. It will be the first book in the series published when its finished.
Rules of Engagement
- Nominate Others. Contribution is by invitation only, but you can nominate others for inclusion by adding them to the 97 Agile Nominations page; please make sure to include an email address. Assume that each author may write one or more contributions.
- Create an account. You can set yourself up with an account (just click create_account) and begin writing your first contribution immediately (see Agile Example Contribution). If you have worked on one of the other 97 things projects, you'll already have a wiki account. Use that.
- Each contributor is asked to provide an axiom (a tip or bit of wisdom) and a brief discussion. The axiom (tip) should only be a 2 to 10 words long if possible. In print, we want each axiom and discussion to fit on a two-page spread. Keep your discussion between 250 and 500 words. Discussions shorter than 250 words are fine, but only ones that are 250 or more are likely to make it into the final book. Instructions for adding your tip are found in the Contributions section below.
- Create an author page. Content on your author pages certainly doesn't count towards your 500 word limit. We'll want (minimally) a bio and a head shot. Only contributions with associated bios (including head shot, and description of background) will be considered for contributions to the book. We may include the bios and head shots in the print version of the book. You may use an icon that's associated with you instead of a picture. Please keep your author page up to date. (Note: If you already created a bio page for some other 97 things project just use that instead of creating a new one).
- After adding your tip in the list in the Contributions sections (instructions provided in that section), clicking on your own name will take you to the author page. Choose the Edit tab to enter in your own bio.
- Add a head shot. Go to the Toolbox along the left hand side of the page. (You may need to scroll up) Click on Upload file, the third item on the toolbox list.
- In the Upload file window, next to the Source filename: entry box, click on the Browse button. Choose the folder on your own computer in which you have stored your photo. Locate the photo you want to use and double click on it. The information will automatically fill in. Click the Upload file button at the bottom on the window. You have now uploaded your photo to the O’Reilly server.
- Go back to the Home Page. Copy this tag [[Image:filename.jpg]]
- Scroll down to the Contributions section and click on your own name. Choose the Edit tab if it is not already selected.
Go to a blank line at the bottom of your bio. Paste in the tag.
- Change the word “filename” to the name of the file with your photo. For example, if your photo was named Barbee.jpg you would type the word Barbee in place of “filename”. Your tag will now read [[Image:Luke.jpg]] If you have a different type of file extension, such as .gif, change .jpg to .gif. Change from the Edit tab to the Article tab to see your photo at the bottom of your biography.
- Add your address and e-mail. Please also add your postal service address and email address to the 97 Agile Addresses page. This information will not be released when the site goes public. We need to keep track of it so that we can send you a free copy of the print book when it's available, and in case in the future O'Reilly's legal department decides we need to get explicit releases from all the contributors prior to publication. If you still don't want to disclose your contact info (and I cannot promise that this site won't "leak" out to the rest of the world), please still add your name to 97 Agile Addresses, and write "I'd prefer not to" or something like that. Then send me your contact info at barbeeonline.cox.net.
- No graphics. Please, no illustrations, graphs, cartoons, or code. We want principles of software project management to be text only. 250 - 500 well-chosen words can say a lot more than a picture.
- Commercial Free. Please keep contributions free from references to specific products or technologies that compare their worth, or paint them in a positive or negative light. For example, don't talk about why you should use Java or .NET; just talk about principles that are valid for any project manager dealing with a software project.
- Editing Ethics. You have the ability to add or change your tip contribution at any time. To be a good participant, please edit your own contribution only. Be very careful that you don't accidentally alter someone else's work.
- Protect the privacy of our site. Please keep this URL private sharing it only with people you invite personally to contribute. Don't link to it, digg it, put it on your web pages, send it out to a mailing list, etc. First, it's only temporary. This book will not live within O'Reilly commons indefinitely. Second, we'd like to keep this under wraps until we have a decent block of material to release.
- Legal Stuff. All contributions made to this site are required to be made under the Creative Commons Attribution 3.0 license. This means that by making a content contribution, you are agreeing that it is licensed to us and to others under this license. If you do not want your content to be available under this license, you should not contribute it.
- Volunteers Only. Contributions are made on a volunteer bases - in other words, contributors are not paid for their contributions. The contributions will be made easily available to everyone on the world wide web for free. However, remember that those of you whose tips are chosen for publication will get your name attached to your work, you picture published next to it, and a free copy of the published book.
- Submit Only Original Work. You warrant that all work that you contribute to this site is your original work, except for material that is in the public domain or for which you have obtained permission.
The Good Stuff
I've added a Sample Contribution Page "Title of an axiom or tip" in the Contributions area to show you an example of the type of screen you will see when your are ready to add your own tip or axiom.
There is also a Video Tutorial prepared by the Series Editor, Richard Monson-Haefel, which shows how to add your first axiom and bio page.
Please add your contributions here. Click the  link on the upper right of this section to add a new contribution. (Do it now.) You can read the rest of these instructions in that window.
A new window will appear with colored icons at the upper left.
Once in the new window, to add your own contribution, click next to an open item number. Click the Ab icon at the top of this page (third from the left). Just start typing the tip you want to add in the highlighted blue area, replacing the words "Link title" which appear inside double brackets. Add - space "by" space - and click the Ab icon again. Type your name to replace the words "Link title" within the brackets.
At the bottom of the page, click the Save page button. You'll be taken back to the Home Page. Click on the red link showing your own tip to be taken to a window where you can either create or cut and paste your 250 to 500 word tip. Remember to click the Save page button at the lower left after you have added your short article.