[BFL] website/documentation

On the BFL webpage, there's a menu item [download]. That entry is
subdivided into 3 separate entries:
- packages
- source code
- subversion access

The "source code" points to the last BFL release, which seems OK to
me. "Subversion access" does not only contain information on how to
get BFL sources via SVN, but it also contains a full installation
manual how to build BFL from (SVN) source.

Wouldn't it be better to split up the documentation based on

- how to get the sources (either by using release tarballs or SVN)
- how to install those sources

instead?

regards,

Klaas
_______________________________________________
I hereby promise not to top-post on the
BFL mailing list
BFL [..] ...
http://lists.mech.kuleuven.be/mailman/listinfo/bfl

Re: [BFL] website/documentation

> Wouldn't it be better to split up the documentation based on
> - how to get the sources (either by using release tarballs or SVN) - how to install those sources
> instead?
Thanks for pointing out this inconsitency.
I proposed a solution which you can check out now on the website.
I have been looking to the other orocos subprojects and apparently the policy is to indicate the different download options in the dowload menu (what's in a name) and to show the installation instructions in the Documentation menu.

Since the text previously appearing when clicking on "Subversion acces" was just a copy-past from the "Getting started guide" I just removed it.
In the mean while I renamed the menu item "Getting started guide" to "Getting started + installation guide", which should point all installation-candidates to this document.

Satisfied or any new suggestions?

[BFL] website/documentation

On 20 Apr 2007 14:11:12 -0000, Tinne De Laet
<tinne [dot] delaet [..] ...> wrote:
[...]
> I proposed a solution which you can check out now on the website.
> I have been looking to the other orocos subprojects and apparently the policy is to indicate the different download options in the dowload menu (what's in a name) and to show the installation instructions in the Documentation menu.
>
> Since the text previously appearing when clicking on "Subversion acces" was just a copy-past from the "Getting started guide" I just removed it.
> In the mean while I renamed the menu item "Getting started guide" to "Getting started + installation guide", which should point all installation-candidates to this document.
>
> Satisfied or any new suggestions?

Very satisfied! :-)
Maybe some stuff can be added to the subversion access section:
- The fact that we don't have any release branches yet
- Links that point to websvn

regards,

Klaas
_______________________________________________
I hereby promise not to top-post on the
BFL mailing list
BFL [..] ...
http://lists.mech.kuleuven.be/mailman/listinfo/bfl