Back To Overview
website suggestion
Posted on 01 Jul, 2013 by FelipeNievinski
The webpage <http://www.gpstk.org/bin/view/Documentation/WebHome> could have a link under the Applications section pointing to the User's Guide, <http://www.gpstk.org/bin/view/Documentation/UsersGuide>.

Add your comments to the Discussion
 

I've prepared the cheat sheet, see PDF file attached. I've taken the liberty of linking it from the GPSTk Applications section of the annotated index, <http://www.gpstk.org/bin/view/Documentation/UsersManualAnnotatedIndex#GPSTk Applications>. I've done that because a user asked me about RinEdit, and it was not listed in that page. FelipeNievinski 19 Feb 2014 - 13:00

Felipe,
Both the PDF and Online version's of the User's Manual will be facing updates and redesigns in the near future, so we will take your suggestions into consideration during this process. Good point about including a comprehensive "cheat sheet" into the package, or at least available on the wiki. Once we have updated the manual and verified the content, we will add this into our list of documentation. Thanks
BryanParsons 22 Oct 2013 - 16:04

Felipe,
I now see what you were implying with the MSVC redistributable. I will make the notation in the "Latest Pre-Compiled Binaries" page. Good suggestion.
BryanParsons 22 Oct 2013 - 09:59

Also, I'd take down <http://www.gpstk.org/bin/view/Documentation/UsersManualOnePage> and keep only <http://www.gpstk.org/bin/view/Documentation/UsersManualAnnotatedIndex> -- I'd think it's unnecessary work to keep them both. Specially considering that users can comment on the wiki, with the possibility of the two versions growing apart. FelipeNievinski 16 Oct 2013 - 08:49

I'd mention this at the top of the HTML version of the User's Manual:

Out-of-date -- please consult the PDF version instead:
<http://www.gpstk.org/pub/Documentation/UsersGuide/gpstk-user-reference.pdf>
FelipeNievinski 16 Oct 2013 - 08:44

Table 3.1, "GPSTk Applications, categorized, with execution examples", from the User's Guide, <http://www.gpstk.org/pub/Documentation/UsersGuide/gpstk-user-reference.pdf>, could be made available as a "cheat sheet" (two pages per sheet, landscape mode) and shipped within the bin directory of pre-compiled binaries. Or if splitting that table would be too much of a hassle, shipping the entire user's guide would be worthwhile (and less than 1/2 MB addition to a ~ 50 MB package). FelipeNievinski 16 Oct 2013 - 08:37

The "System Requirements" webpage refers to building gpstk; I was referring to simply running the pre-compiled binary. The MSVC compiler is required for the former, while the latter requires the MSVC redistributable. FelipeNievinski 16 Oct 2013 - 08:27

Felipe,
In reference to the "TWiki" link at the bottom left of the website, we are currently looking at trimming down access across the website and the entire left sidebar will come under scrutiny. This will most likely lead to removal and reorganization of some of the links (TWiki being among these).
BryanParsons 11 Oct 2013 - 08:02

Felipe,
For the link to the Microsoft Visual Studio, rather than add it to the "Latest Pre-Compiled Binaries" Section, I've added hyperlinks to the "A Modern C++ Compiler" section under the System Requirements page for both Visual Studio 2010 and Visual Studio 2012. I think providing direct links to current Visual Studio packages is a good suggestion, and we appreciate the thoughtful suggestions.
BryanParsons 11 Oct 2013 - 08:00

The link to "TWiki", at the bottom left corner of the website, could go away, it seems. FelipeNievinski 10 Oct 2013 - 08:20

In the main page, where it says "Latest Pre-Compiled Binaries", it could be mentioned: "Windows users will need the Microsoft Visual C++ Redistributable Package", with a link to <http://www.microsoft.com/en-us/download/details.aspx?id=30679>. FelipeNievinski 10 Oct 2013 - 08:18

Hello Felipe,

I found these to be very good suggestions, and have added links to the Users Guide and Pre-Compiled binaries on the main GPSTk Documentation page. In reference to updating the manuals, we currently generate the HTML files automatically and have plans to update them in the near future.

Thanks for taking the time to make these suggestions and we appreciate your support and interest in the GPS Toolkit.

BryanParsons 06 Aug 2013 - 10:00

One more: the Online Reference Manual, both one-pager and as annotated index, is outdated in comparison to the PDF User's Manual. I was inclined to update the former manually, but I wanted to check whether it's supposed to be just an HTML version of the latter. In this case it could be generated automatically I guess. Thanks. FelipeNievinski 30 Jun 2013 - 22:24

It could also have a link to the latest precompiled binaries, e.g., <http://sourceforge.net/projects/gpstk/files/latest/download?source=dlp> seems to detect the user's platform. FelipeNievinski 30 Jun 2013 - 22:21



Topic revision: r8 - 19 Feb 2014, FelipeNievinski
 

This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback