[Networkit] Retiring the User Guide
henning.meyerhenke at kit.edu
Tue Feb 16 16:56:48 CET 2016
Outdated documentation is indeed a problem. There should be something
easy to get users started, though. I don't think that module
documentation alone does that job for most people -- at least not in its
Moreover, the new profiling module is hardly explaining what the user
sees and how to interpret these statistics -- in that respect the old
user guide was better and its properties.overview(G) feature was
Thus, please make sure that (i) there is a single entry point in form of
a notebook for a new user ("user guide" would indeed still be an
appropriate name for that), which can then refer to special-purpose
notebooks and that (ii) the profiling mechanism sees more explanation.
Michael Wegner can assist you with both, he will soon work on the
documentation and the website anyway.
Am 16.02.16 um 12:00 schrieb Christian Staudt:
> By now the User Guide  is outdated and Ive received several
> emails from people who tried to follow it and got error messages. I
> propose to take it offline for now to minimize damage. I think it is
> also conceptually outdated, so Im not motivated to just patch it up.
> Alternatives to the guide are in my opinion improving the module
> documentation (docstrings, help(networkit) etc.) so that users learn
> things as they explore the code. Additionally, putting several
> example notebooks on the website for different tasks could may be
> better than one comprehensive guide.
> _______________________________________________ NetworKit mailing
> list NetworKit at ira.uni-karlsruhe.de
Karlsruhe Institute of Technology (KIT)
Institute of Theoretical Informatics (ITI)
Prof. Dr. Henning Meyerhenke
Theoret. Informatics / Parallel Computing
KIT - The Research University in the Helmholtz Association
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 5399 bytes
Desc: S/MIME Cryptographic Signature
More information about the NetworKit