On Sun, May 3, 2009 at 2:50 AM, Joe Barnhart <[email protected]> wrote:

>
> Yarko --
>
> I can't say about others, but for me the key missing features in the
> wiki are:
>
> * Wiki-style links and organization
> * Easy navigable URLs
> * More compact and usable layout


Thanks, Joe, for the concrete and useful points.

I would add that if you don't display a page (e.g. still working on it) I
could find no way to get back to it.
Also, the RST levels seem to be top-level, and some of the text too large;
when I compare how PyCon site handles the docutils module setup, I think we
need to look at emulating some of that setup.


>
>
> All wikis I have used in the past use embedded WikiStyleTags to create
> links to other pages on the wiki, or even create stub pages
> automatically.  Ours does not.  It's linking is very cumbersome and
> more like a traditional web page.
>
> URLs in most wikis are related to the linked pages, so the page above
> might have a link of http://www.ourwiki.com/wikistyletags.  It makes
> the page easily reachable and much more accessible than an
> automatically generated crypto-garf name.
>
> The layout of the current wiki is very large and diffuse.  It feature
> enormous titles, big fonts, and just does not use space efficiently.
> I know it's a style thing, but style is important too.  This is less
> important than the wiki features already mentioned, but it ranks
> somewhere.
>
> I don't want anyone to feel like I'm telling them what to do.  I am
> just a messenger, bearing the bad news that we still do not have
> significant community involvement in solving our documentation
> dilemma.  While I am becoming more proficient at reading Python ;-), I
> believe we need more accessible documentation if we are ever to take
> on Django or PHP.
>
> On May 2, 2:44 pm, Yarko Tymciurak <[email protected]> wrote:
> > talk is cheap...
> >
> > ...there is no shortage of opinions or advice on what "others should do",
> or
> > (worse) what "others should stop doing"  (as I read this all)...
>
> >
>

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"web2py Web Framework" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/web2py?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to