Skip to main content
[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

Back to the top