WICSA 2005:Page Contribution Walk-thru

From WICSA Conference Wiki

This walk-thru gives you an exemplar to quickly contribute a page to Wiki.

1. Think about what you want to contribute.
   • Does it fit within an existing page? If so, go edit that page and add your content to it.
   • Is it new content that doesn't fit in any existing page? If so, you'll need to create a new page, so please continue reading...
2. Find an appropriate page P from which to link to your to-be-created page X.
   • A good heuristic to determine P is to consider the context in which your content makes sense, perhaps the idea came during a working session discussion, in which case you may consider linking from that session's discussion page.
   • If no P fits, you may consider the front page of WICSA 5, as was the case with Elliot Chikofsky's WCRE General Chair's message. (Please note, though, that admins may choose to re-locate your page link.)
3. Consider what you would like to name your page X.
4. Edit page P and add this name as a link. Save page.
5. On page P, click on the new link for page X to get the edit page. Add your content.
6. Save page. Voilà! you've created page X.

Here's a concrete example, using Elliot's page, WICSA 2005:Reverse Engineering and Software Architecture...

1. Elliot wanted to add a page on this subject and provide a link to the PDF version of his message.
   • This didn't really fit well in any existing page.
   • Elliot considered it new content.
2. His content targets a topic that spans both of the two joint conferences, so it fit no where else except the WICSA 5 main page.
3. Name of page X: WICSA 2005:Reverse Engineering and Software Architecture
4. Elliot edited the "What's New" section of the WICSA 5 main page, adding a bullet, as below.
   • Notice the page label as distinguished from the page name. You may choose to do that.
5. After saving the added link, from the WICSA 5 main page again, Elliot clicked on his new page link and started adding his content.
   1. First, he uploaded his PDF file, which he would be using in his page:
      1. Click the "Upload file" link in the toolbox on the left of the page.
      2. Browse for the source file and copy-and-paste the auto-generated "Destination filename" (in this example, "WCRE 2005 Gen Chair message.pdf").
      3. Optionally add a summary, then click "Upload file".
   2. Going back to the page he's creating, he added the text content, and included a link to his uploaded media, as below.
6. Elliot previews his page and finally saves it.

Bullet added to page P:

 * [[WICSA 2005:Reverse Engineering and Software Architecture|
 Discussion of the relationship between software architecture and reverse engineering.]]

Link to uploaded media file:

 [[Media:WCRE 2005 Gen Chair message.pdf]]