The structure of the various types of help/assistance/information is not clear. Here are some ideas:
On the LT home page, there are links to Forum and Development. The welcome message on the Forum page should specify who the forum is for (end users, LT developers, both). Possibly, change the name to User Forum. Also, include a link to the Development Overview and the bug tracker. On the Development page, change 'Archive at Sourceforge' to something like 'Developer messages on Sourceforge', and put the text below 'Subscribe'. Clarify the phrases to 'Archive at mail-archive.com' and 'Archive at markmail.org'. These pages seem to show the same e-mail messages that are on Sourceforge. Development page: "wiki.languagetool.org contains the complete development documentation, including:" If the only purpose of wiki.languagetool.org is for development information, then change the name from 'wiki.' to 'development.' Reason: 'wiki' tells me it's a wiki, but 'development' tells me its purpose, which is much more useful. Development page: "Development Overview, for users who want to extend LanguageTool with their own rules". But, the three-minute introduction is also for people who want to add their own rules. Remove the link to the three-minute introduction, because it is the first subheading on the Development Overview page and people will see it immediately. Probably, this is sufficient: To learn how to add your rules to LanguageTool, refer to the Development Overview. On wiki.languagetool.org, remove the links that are in the top right of the page: * Development has only 2 links, not the full set of links. 'Tips and Tricks' is in the left navigation. 'Developing a tagger dictionary' is probably not useful, but if it is necessary, it should be with the other links on the left navigation. * Contact. Put a contact link on the left navigation. Remove http://wiki.languagetool.org/contact and add a contact page on the main LT site. http://wiki.languagetool.org/ : "This is a wiki for developers and users of LanguageTool," What's a wiki and why do I care? Remove all instances of 'wiki', when the word is used to describe the way in which the documentation is supplied. If necessary, use something like, "This section of the LT website..." In a previous message, Sharad wrote: This will aggregate all development related information at one place and a user can reach there by a single click. Yes, please. The current structure is confusing. Regards, Mike Unwalla Contact: www.techscribe.co.uk/techw/contact.htm -----Original Message----- From: Daniel Naber [mailto:daniel.na...@languagetool.org] Sent: 29 March 2016 19:48 To: development discussion for LanguageTool Subject: Re: Link to LT Wiki On 2016-03-29 13:04, Sharad Sinha wrote: Hi Sharad, > Also, the current "WikiCheck" tab may seem confusing, at least it was > to me initially. I thought it to be the link to wiki but it turned out > that it allows running LT on Wikipedia as a demonstration of its > strength. Perhaps "Wikipediacheck" might be better. I've renamed it. Any other opinions about the development/Wiki links? Regards Daniel ------------------------------------------------------------------------------ Transform Data into Opportunity. Accelerate data analysis in your applications with Intel Data Analytics Acceleration Library. Click to learn more. http://pubads.g.doubleclick.net/gampad/clk?id=278785471&iu=/4140 _______________________________________________ Languagetool-devel mailing list Languagetool-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/languagetool-devel
