[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [buckminster-dev] New to Buckminster
|
Hi Matt,
I think the most important things right now is the content itself and to get it structured in a way
that makes it easy to navigate. IMO this is the difficult part. The actual medium can be changed
once we have that.
Stefan Daume has written most of the content that we have on the wiki rigth now. I think it would be
great if you could sync up on ideas on to move forward with this to make it as efficient as possible.
My view is that you should use whatever tool you're most comfortable with. Our ultimate goal is
actually not the wiki, it's getting the documentation into the Eclipse Help system as part of the
features that we provide. The format for that will be html.
Regards,
Thomas Hallgren
Matt Hollingsworth wrote:
Thomas (and others),
Great! I'll get started properly as soon as I get back home to the States
(I'm in Switzerland [at CERN] at the moment, and I'm leaving tomorrow).
However, I can go ahead and ask some questions that I know I'll need to
ask...
First off, if I'm going to be doing documentation I had better first inquire
what format you prefer. I'm sure that the ultimate goal is to put things on
the wiki, but unless there are objections, I would probably prefer to
produce whatever I'm producing first using another medium that one could
test and proof before it's available on the wiki so that bad information
isn't accidentally published. If I'm going to do things that way, I might
as well make it useful in the long run as well, so that at some point, a pdf
or similar may be produced as a user's guide from it. I'm quite familiar
with LaTeX, so I would be perfectly comfortable with that, but if no one
else likes that, or if there is simply something better, I'm not married to
it by any means.
Other than that, I'll just start with the getting started guide, and see
what happens :).
-Matt
-----Original Message-----
From: buckminster-dev-bounces@xxxxxxxxxxx
[mailto:buckminster-dev-bounces@xxxxxxxxxxx] On Behalf Of Thomas Hallgren
Sent: Thursday, March 20, 2008 9:19 PM
To: Buckminster developer discussions
Subject: Re: [buckminster-dev] New to Buckminster
Hi Matt,
it sounds like we have a lot of common objectives and we would of course
welcome your efforts. From
the sound of it, your aim just right. Let me know what I can do do help get
you started.
Kind Regards,
Thomas Hallgren
Matt Hollingsworth wrote:
Hello,
I would first like to mention that I'm interested in contributing
whatever I can find the time to contribute to this project; I had just
(a couple of weeks ago) begun a project that aimed to do what this
project has already done (for the most part) before I knew about
Buckminster. My least favorite thing about programming is trying to
resolve dependencies for complex projects, and as far as I'm concerned,
it's worth the effort to make it such that I can just run a command and
have that step done for me. I really like how you are approaching the
problem (although I can't get anything other than the sample to work
myself, but that's a problem in implementation [ which I would like to
help with ], not the idea behind it :) ).
If it's ok if I help you guys out, the first thing I'm interested in
helping with, just to get acquainted with the project, is by doing
whatever I can to help smooth out some rough edges in the documentation.
This, I thought, might help me understand everything better, and it
would give you someone to test code coverage, as I'm going to try
everything out before I document it. I would then help as much as I can
with the debugging, which would also help me get acquainted with the
code (and, more importantly, the group). After that, I hope to be in a
position to contribute a bit more, if it is desired of me.
If this is desirable, let me know, and I'll get to work; conversely, if
you wish for me to stay out of the way, that is fine as well :).
Thanks,
Matt Hollingsworth
CERN - CMS (http://cms.cern.ch/)
_______________________________________________
buckminster-dev mailing list
buckminster-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/buckminster-dev