Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-12) was last changed on 16-Mar-2011 21:28 by Janne Jalkanen  

This page was created on 12-Nov-2003 01:35 by

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 257 added 2 lines
!! Make Common Variations Of Words Point To The Same Page
At line 260 added 2 lines
The idea is to have only one copy of content for a topic
yet have it accessible via any natural link.
At line 263 added one line
!! Add Links for Abbreviations
At line 265 added 2 lines
Abbreviations are common example of multiple links pointing to the
same content.
At line 268 added 3 lines
For example, the link [LM] and the link [LineModule]
both point to the same content. The real link us under
LM. LineModule uses the [TranscludePlugin] to point to LM.
At line 272 added one line
!! Add Links for Different Wording for the Same Thing
At line 274 added 3 lines
Make different wordings for the same thing point to one place
using the [TranscludePlugin]. This idea is related to
[Use This WikisA bility To Make Natural Looking Links].
At line 278 added 4 lines
For example, the idea of decoupling is used in several different
contexts. In order to provide links that fit naturally in
text, several different ways of saying decoupling were created:
[decoupling], [decoupled], [decouple], [DecouplingPatterns].
At line 284 added 104 lines
!! Do Not Add A Title On Each Page
Your page name can serve as your page title because
page names are already displayed with spaces.
No other page title is necessary. When making bigger pages out
of smaller pages using the [TranscludePlugin] it makes
the documents flow better by not having a title. The
big document can decide on the title.
!! Use Bullets And Headers For Quick Scanning
People read wiki for information. Whenever a reader sees a big block
of text they just might keep moving on. There are some techniques
to help structure text so people are more likely to read it.
!! Add Headers
Add paragraph headers using the [exclamation | TextFormattingRules ]
points. Headers allow people to quickly scan a page for the
information they want.
!! Add Bullets
* If a paragraph makes multiple points then organize it using [bullet | TextFormattingRules ] lists.
* This tells readers immediately how many items there are to pay attention to.
!! Add a Table of Contents Jump Table
At the top of page create a table of contents with links that
jump to a point in the same page. This currently requires the use of html.
See [Build Environment] for an example.
!! Add Line Breaks to Separate Largish Sections
Use the {{{----}}} line graphic before a heading to separate larger
chunks of text on the same page. Very effective with the [table
of contents jump table].
Consider that you should [Pull Content Out Into Its Own Page].
!! Every Line is a Separate Paragraph
This is a variation of using bullets without the bullets.
Don't run two or more sentences together in one paragraph.
Instead, separate each sentence into its own paragraph.
This makes it easy for people to read because each paragraph
represents a separate thought.
!! Use Just The Right Amount Of Links
Like Goldilocks there is an amount of linking that is just right.
!! Do Not Link to Every Word or Phrase
This looks so bad on the page it just annoys people so they
won't read the content.
!! Link to the First Use of a Word or Phrase
You don't need to link to every occurrence of a word or phrase.
Linking to the first use of a word or phrase is sufficient.
!! Link to What You Want People to Read
If you don't link to something it is unlikely readers
will take the time to search for it. So link to everything
you want people to read.
!! Pull Content Out Into Its Own Page
If you see information in a page that can stand on its own then
pull it out and make it have its own page. Then make the original
page link to it or include it.
See [Create Knowledge Nugget Pages With Useful Titles] and
[How To Organize Wiki] for more information.
!! Add Links To Main Page
The main page has a link section for home pages and community topics. Put links to your pages where appropriate so other people can find your topics.
Version Date Modified Size Author Changes ... Change note
12 16-Mar-2011 21:28 13.269 kB Janne Jalkanen to previous
11 16-Mar-2011 20:03 14.963 kB TomrapGeore to previous | to last
10 06-Apr-2010 06:11 13.272 kB to previous | to last
9 06-Apr-2010 06:10 13.335 kB to previous | to last
8 08-Mar-2007 23:55 13.269 kB MurrayAltheim to previous | to last removed noise
7 08-Mar-2007 23:50 13.131 kB JACK BAUER to previous | to last
6 08-Mar-2007 23:49 13.339 kB JACK BAUER to previous | to last Comment by JACK BAUER
5 08-Apr-2006 11:50 13.269 kB Christoph Sauer to previous | to last
4 07-Apr-2006 21:41 13.352 kB Brett to previous | to last
3 06-Jun-2005 15:00 13.285 kB to previous | to last
2 12-Nov-2003 01:47 13.284 kB to previous | to last
1 12-Nov-2003 01:35 9.372 kB to last
« This page (revision-12) was last changed on 16-Mar-2011 21:28 by Janne Jalkanen