document dependency graph

[Rene Ladan]

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)