Date: Sat, 03 Jan 2009 16:56:08 +0100 From: Rene Ladan <r.c.ladan@gmail.com> To: Manolis Kiagias <sonic2000gr@gmail.com> Cc: doc@freebsd.org Subject: Re: document dependency graph Message-ID: <495F8A98.6070602@gmail.com> In-Reply-To: <495EABC9.9020103@gmail.com> References: <e890cae60901021540h5a587ccer4edb8ba1f651e0cc@mail.gmail.com> <495EABC9.9020103@gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Manolis Kiagias schreef: > Rene Ladan wrote: >> Hi, >> >> I've made a document dependency graph showing which articles and books >> depend which other articles and/or books. >> >> The graph can be viewed at http://www.rene-ladan.nl/freebsd-doc-graph/ >> (both the graphviz source and two renderings in PNG format) >> >> The graph was made manually (!) using the output from >> grep -ir -E 'url.articles|url.books|www.freebsd.org' * | sort | uniq >> in the articles/ and books/ directory of the current English documentation >> set. So hopefully I didn't miss anything. >> >> Maybe the graph is useful for translation teams deciding what to translate >> next (to avoid having to link to a lot of non-translated texts). >> >> Regards, >> Rene >> > Now, I would really call that complex! Heh, typing is also difficult, I noticed I a typo in "contributors", which is fixed in the meantime. Maybe I should write a sh/perl script to automate the generation. Or make a article-only and book-only graph. > Most everything connects to the handbook, so finishing it gives a > translator more than a few options of articles to move on. Or books. There are both standalone articles and books. Note that there are also books and articles which refer to each other (e.g. faq and handbook, pr-guidelines and problem-reports). > Another possibly interesting graph would be which handbook chapters > connect to other handbook chapters (for more or less the same reason: to > translate the most linked to chapters first). > I think detecting incoming links in chapters is more difficult than detecting incoming links in books/articles, since in the former case one has to recognize anchor titles, while in the latter case URLs suffice. > Nice work, thanks Rene ;) > Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = E738 5471 D185 7013 0EE0 4FC8 3C1D 6F83 12E1 84F6 (subkeys.pgp.net)
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?495F8A98.6070602>