Re: [Boost-docs] [ping]questions about boost documentation

Subject: Re: [Boost-docs] [ping]questions about boost documentation
From: Matias Capeletto (matias.capeletto_at_[hidden])
Date: 2007-08-21 22:02:34

Hi Robert,

On 8/20/07, Joel de Guzman <joel_at_[hidden]> wrote:
> John Maddock wrote:
> > Robert Ramey wrote:
> >> I'm disappointed that no one who is actually doing this work
> >> responded to this post.

I have been in a FLOSS congress last week. I have been trying to
navigate over the avalanche of mails, I miss this one.

> >>If there is some reason that my
> >> concerns/suggestions aren't a good idea, I would be
> >> interested in knowing about it.

It is a very good idea Robert. IBD folks are working very hard in a
lot of fronts. Please be patient, we are now more than 20 devels and
we are starting to have real workforce. You must understand that only
2 months has pass from IBD first steps.

Please read this section of our wiki, it was one of the first things we wrote:
http://svn.boost.org/trac/boost/wiki/DocsOrganization

Is something like this what you want?

> >>The whole documentation initiative has progressed with almost no review or testing or
> >> as far as I can see input from developers who need/use the system.

I really do not follow you here. We are not forcing nothing, just
trying to improve things. And we have a lot of communication channels
open, we ask feedback for almost any move.
We are very open to discussion. I apologize no one answer you before,
but almost each IBD devel has a lot of things to do.

> >> The fact that a couple of
> >> libraries have addressed these concerns in an ad-hoc
> >> way suggests that I'm not alone in this.

True, that is what we are trying to improve, please be patient :)

> >> Why are things being done they way are rather
> >> than the way I've suggested.  Is there a real reason
> >> or were no alternatives originally considered?

I think that the above proposal is similar to what you are asking for.
Please check it and give feedback to us.

> > Not sure, but actually I think the IDB folks are moving somewhat in the
> > direction you suggest: things that should be centralised (style sheets icons
> > etc) are, while library specific docs live under libs/name/doc/html.

Yep.

> > I suspect that Matias has been busy, given that he's been awfully quiet
> > lately, but will no doubt reply in time.

Very busy :)
I have started to work in the OS movement in Argentina. I was feeling
very lonely :)
I already find some cool folks to help us at IBD... more friendly
hands from Argentina!

> > That's the way that the sandbox is organised at present anyway, and as I
> > said in a previous reply to your message, some of us are already using this
> > structure.

Stjepan has been working on this front. Public kudos to him :)

> Patience ;-)... Anyway, FWIW, I'm all for Robert's suggestions.

Again, sorry for the delay Robert.
King regards
Matias