From owner-freebsd-doc@FreeBSD.ORG Sat Jan 3 15:56:14 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0E0DC106566C for ; Sat, 3 Jan 2009 15:56:14 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from mail-ew0-f21.google.com (mail-ew0-f21.google.com [209.85.219.21]) by mx1.freebsd.org (Postfix) with ESMTP id 907468FC0C for ; Sat, 3 Jan 2009 15:56:13 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by ewy14 with SMTP id 14so8070315ewy.19 for ; Sat, 03 Jan 2009 07:56:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :x-enigmail-version:content-type:content-transfer-encoding; bh=sJ/yb3MO5EzE8GZks2iEVE6Skhzv0uRlbtMZHEI4BwM=; b=weRVyWWuIQM7bs03cm0woE0ooo1ndiVZR/mpvc4InH8K7fOLU1ZrDuEpTPMcYs12hf ulzx2HLALEKm0gLvTEWh1lxvBdW7/umYgawG3fXzTSCXOKUivxgYhknZaFSMQpn9RjyM 3VM0cFmKrxPSBtlrZV0/N8WT5dpI2xZLcKJBU= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; b=a5H19yiv7bvJWRQ0ajOK/OKwl0VTpdLllDU/16KX6MJTgCvz4eyIleQSi7ckATgMlm FF9bVQFSKltnRe6VjjFFqWOS87E2RJZAAm2vpo7vCms7IrhBhE0vjbqXsYnTqzhYwCPn x4sRSQvrTLmS8nIvceOyQh1HG6MU2ptrB/zEY= Received: by 10.210.58.13 with SMTP id g13mr574168eba.152.1230998172447; Sat, 03 Jan 2009 07:56:12 -0800 (PST) Received: from self.rene-ladan.nl ([77.163.174.49]) by mx.google.com with ESMTPS id h7sm46252043nfh.67.2009.01.03.07.56.10 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sat, 03 Jan 2009 07:56:11 -0800 (PST) Message-ID: <495F8A98.6070602@gmail.com> Date: Sat, 03 Jan 2009 16:56:08 +0100 From: Rene Ladan User-Agent: Thunderbird 2.0.0.19 (X11/20090103) MIME-Version: 1.0 To: Manolis Kiagias References: <495EABC9.9020103@gmail.com> In-Reply-To: <495EABC9.9020103@gmail.com> X-Enigmail-Version: 0.95.6 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org Subject: Re: document dependency graph X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Jan 2009 15:56:14 -0000 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)