On Monday, April 6, 2015 at 10:45:13 AM UTC-4, Maricel Gregoraschko wrote: > > > Well, we (the community) run the Wiki. What do you suggest? We can make > the changes if they seem like they would be helpful. > > I would say that first of all the new visitor needs to be made aware that > these pages exist. Because browsing through the wiki site you only see > "Denis Bider's Crypto++ User Guide" which is very short and dated. > > A hierarchical table of contents, or at least a categorized list of pages > would be very good. > OK, the real estate on the home page is kind of limited, so we can't place everything on it.
Mediawiki has a couple of special pages (see the toolbox on the right) that lists all pages (http://www.cryptopp.com/wiki/Special:AllPages) and provide a random page from the wiki (http://www.cryptopp.com/wiki/Special:Random). We also have this: http://www.cryptopp.com/wiki/Go_versus_Search, but I never thought to highlight it. Maybe the graphic should be moved to the homepage with a note about searching. > That could be some work, but how about just flatly listing all the wiki > pages in an html that's linked to from the web page. Just the directory > listing, and perhaps other pages too if they are not all in the same > directory. That should be straightforward to do. > It seems like Mediawiki's http://www.cryptopp.com/wiki/Special:AllPages is the tool for the job here. You can also post a text on the main wiki page that says "if you search a > class name in the search box below, you will get additional documentation", > or "you can form URLs by adding a class name to... > OK, I think the solution here is to put the graphic on the main page to draw attention to it with some text that highlights search. > > Take consolation in the fact that the wiki has only been around since > about 2005 or so. It was quite painful before then :) > I felt that pain full force, as I had no idea anything else existed other > than what's linked to from the crypto++ home page and wiki page. And any > newcomer is bound to experience the same, guaranteed. > Yeah, that's a problem. That's why I try to answer in terms of the wiki (even when a simple code snippet would do). It raises awareness for the wiki so you know where to find things. Jeff -- -- You received this message because you are subscribed to the "Crypto++ Users" Google Group. To unsubscribe, send an email to [email protected]. More information about Crypto++ and this group is available at http://www.cryptopp.com. --- You received this message because you are subscribed to the Google Groups "Crypto++ Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
