Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Buckminster dev » The Bucky Book 0.2 rough cut is available
The Bucky Book 0.2 rough cut is available [message #36818] Wed, 01 July 2009 09:48 Go to next message
Henrik Lindberg is currently offline Henrik Lindberg
Messages: 2492
Registered: July 2009
Senior Member
Summer is here - and you may be wondering what you are going to be doing
on the beach. Well, here is an item to put on your reading list...

For some time now I have been working on a book (available in PDF, under
EPL - link at the end of this post) called "Eclipse Buckminster - The
Definitive Guide". As the title suggests, it is supposed to cover
"everything".

The 0.2 draft of the book has several chapters in decent shape:
- Buckminster Introduction (based on talk at EclipseCon '09)
- P2 Introduction (parts needs work though)
- RMAP chapter (the rmap explained - not only what to write, but why)
- CQUERY chapter (what and why)
- Properties

Currently about 70 pages of "chapter text" or so are in near finished shape.

And Reference Appendixes
- Installation
- Omni Version
- XML Schema Namespaces Reference


I am hoping that this book help everyone, and especially newbies, as the
RMAP and CQUERY artifact are the two first things (after installation)
that a user encounters, and with very little documentation as support.

You can help in several ways:
- On a read through, if explanations does not make sense to you, or you
think others may misunderstand - please comment.
- If you find errors (that Thomas did not spot ;) - he will buy you a
beer :)
- If you have examples, snippets of XML where you solved a tricky issue
with some mapping etc. then please share! You don't have to write it up,
just give me some bullets or highlights, and I will turn it into text.

At this point, I don't need input on typography, spelling errors, and
missing references/links.

If you have a few comments, then you can just post them here and point
to page/section etc. If you want to contribute more, you can add
comments to the PDF directly and mail it to me.

The Book is produced using DocBook and XSLT stylesheets, and Apache FOP.
Currently the book is not checked into Buckminster SVN, but it will be.
And I think we will have a documentation category for Buckmisnter in the
Bugzilla.

Let me see - was there anything else... Oh, the link :)

If you are a Friend of Eclipse:
http://friends.eclipse.org/downloads/tools/buckminster/doc/B uckyBook.pdf

Otherwise:
http://www.eclipse.org/downloads/download.php?file=/tools/bu ckminster/doc/BuckyBook.pdf
(And if you want to skip the mirror selection, put a &r=1 at the end -
but currently the mirrors are not updated, so you may get a 404.)

The PDF is about 6Mb in size. Enjoy...

Regards
Henrik
Re: [buckminster-dev] The Bucky Book 0.2 rough cut is available [message #36854 is a reply to message #36818] Wed, 01 July 2009 10:07 Go to previous messageGo to next message
Guillaume Chatelet is currently offline Guillaume Chatelet
Messages: 146
Registered: July 2009
Senior Member
--001485f6d2a41ff374046da5748f
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit

Brilliant !Thank you so much for this. I'm sure this book will help *a lot*.
I'll try to get back to you with insightful comments.

Cheers and well done !
Guillaume

On Wed, Jul 1, 2009 at 3:48 PM, Henrik Lindberg <
henrik.lindberg@cloudsmith.com> wrote:

> Summer is here - and you may be wondering what you are going to be doing on
> the beach. Well, here is an item to put on your reading list...
>
> For some time now I have been working on a book (available in PDF, under
> EPL - link at the end of this post) called "Eclipse Buckminster - The
> Definitive Guide". As the title suggests, it is supposed to cover
> "everything".
>
> The 0.2 draft of the book has several chapters in decent shape:
> - Buckminster Introduction (based on talk at EclipseCon '09)
> - P2 Introduction (parts needs work though)
> - RMAP chapter (the rmap explained - not only what to write, but why)
> - CQUERY chapter (what and why)
> - Properties
>
> Currently about 70 pages of "chapter text" or so are in near finished
> shape.
>
> And Reference Appendixes
> - Installation
> - Omni Version
> - XML Schema Namespaces Reference
>
>
> I am hoping that this book help everyone, and especially newbies, as the
> RMAP and CQUERY artifact are the two first things (after installation) that
> a user encounters, and with very little documentation as support.
>
> You can help in several ways:
> - On a read through, if explanations does not make sense to you, or you
> think others may misunderstand - please comment.
> - If you find errors (that Thomas did not spot ;) - he will buy you a beer
> :)
> - If you have examples, snippets of XML where you solved a tricky issue
> with some mapping etc. then please share! You don't have to write it up,
> just give me some bullets or highlights, and I will turn it into text.
>
> At this point, I don't need input on typography, spelling errors, and
> missing references/links.
>
> If you have a few comments, then you can just post them here and point to
> page/section etc. If you want to contribute more, you can add comments to
> the PDF directly and mail it to me.
>
> The Book is produced using DocBook and XSLT stylesheets, and Apache FOP.
> Currently the book is not checked into Buckminster SVN, but it will be. And
> I think we will have a documentation category for Buckmisnter in the
> Bugzilla.
>
> Let me see - was there anything else... Oh, the link :)
>
> If you are a Friend of Eclipse:
> http://friends.eclipse.org/downloads/tools/buckminster/doc/B uckyBook.pdf
>
> Otherwise:
> http://www.eclipse.org/downloads/download.php?file=/tools/bu ckminster/doc/BuckyBook.pdf
> (And if you want to skip the mirror selection, put a &r=1 at the end - but
> currently the mirrors are not updated, so you may get a 404.)
>
> The PDF is about 6Mb in size. Enjoy...
>
> Regards
> Henrik
> _______________________________________________
> buckminster-dev mailing list
> buckminster-dev@eclipse.org
> https://dev.eclipse.org/mailman/listinfo/buckminster-dev
>

--001485f6d2a41ff374046da5748f
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Brilliant !<div>Thank you so much for this. I&#39;m sure this book will hel=
p *a lot*.</div><div>I&#39;ll try to get back to you with=C2=A0<span class=
=3D"Apple-style-span" style=3D"border-collapse: collapse; font-family: Aria=
l; white-space: pre; -webkit-border-horizontal-spacing: 2px; -webkit-border=
-vertical-spacing: 2px; ">insightful </span>comments.</div>

<div><br></div><div>Cheers and well done !</div><div>Guillaume<br><br><div =
class=3D"gmail_quote">On Wed, Jul 1, 2009 at 3:48 PM, Henrik Lindberg <span=
dir=3D"ltr">&lt;<a href=3D"mailto:henrik.lindberg@cloudsmith.com">henrik.l=
indberg@cloudsmith.com</a>&gt;</span> wrote:<br>

<blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1p=
x #ccc solid;padding-left:1ex;">Summer is here - and you may be wondering w=
hat you are going to be doing on the beach. Well, here is an item to put on=
your reading list...<br>


<br>
For some time now I have been working on a book (available in PDF, under EP=
L - link at the end of this post) called &quot;Eclipse Buckminster - The De=
finitive Guide&quot;. As the title suggests, it is supposed to cover &quot;=
everything&quot;.<br>


<br>
The 0.2 draft of the book has several chapters in decent shape:<br>
- Buckminster Introduction (based on talk at EclipseCon &#39;09)<br>
- P2 Introduction (parts needs work though)<br>
- RMAP chapter (the rmap explained - not only what to write, but why)<br>
- CQUERY chapter (what and why)<br>
- Properties<br>
<br>
Currently about 70 pages of &quot;chapter text&quot; or so are in near fini=
shed shape.<br>
<br>
And Reference Appendixes<br>
- Installation<br>
- Omni Version<br>
- XML Schema Namespaces Reference<br>
<br>
<br>
I am hoping that this book help everyone, and especially newbies, as the RM=
AP and CQUERY artifact are the two first things (after installation) that a=
user encounters, and with very little documentation as support.<br>
<br>
You can help in several ways:<br>
- On a read through, if explanations does not make sense to you, or you thi=
nk others may misunderstand - please comment.<br>
- If you find errors (that Thomas did not spot ;) - he will buy you a beer =
:)<br>
- If you have examples, snippets of XML where you solved a tricky issue wit=
h some mapping etc. then please share! You don&#39;t have to write it up, j=
ust give me some bullets or highlights, and I will turn it into text.<br>


<br>
At this point, I don&#39;t need input on typography, spelling errors, and m=
issing references/links.<br>
<br>
If you have a few comments, then you can just post them here and point to p=
age/section etc. If you want to contribute more, you can add comments to th=
e PDF directly and mail it to me.<br>
<br>
The Book is produced using DocBook and XSLT stylesheets, and Apache FOP. Cu=
rrently the book is not checked into Buckminster SVN, but it will be. And I=
think we will have a documentation category for Buckmisnter in the Bugzill=
a.<br>


<br>
Let me see - was there anything else... Oh, the link :)<br>
<br>
If you are a Friend of Eclipse: <a href=3D"http://friends.eclipse.org/downl=
oads/tools/buckminster/doc/BuckyBook.pdf" target=3D"_blank">http://friends.=
eclipse.org/downloads/tools/buckminster/doc/BuckyBook.pdf</a ><br>
<br>
Otherwise: <a href=3D"http://www.eclipse.org/downloads/download.php?file=3D=
/tools/buckminster/doc/BuckyBook.pdf" target=3D"_blank">http://www.eclipse.=
org/downloads/download.php?file=3D/tools/buckminster/doc/Buc kyBook.pdf </a><=
br>


(And if you want to skip the mirror selection, put a &amp;r=3D1 at the end =
- but currently the mirrors are not updated, so you may get a 404.)<br>
<br>
The PDF is about 6Mb in size. Enjoy...<br>
<br>
Regards<br>
Henrik<br>
_______________________________________________<br>
buckminster-dev mailing list<br>
<a href=3D"mailto:buckminster-dev@eclipse.org" target=3D"_blank">buckminste=
r-dev@eclipse.org</a><br>
<a href=3D"https://dev.eclipse.org/mailman/listinfo/buckminster-dev" target=
=3D"_blank">https://dev.eclipse.org/mailman/listinfo/buckminster-dev</a><br=
>
</blockquote></div><br></div>

--001485f6d2a41ff374046da5748f--
Re: [buckminster-dev] The Bucky Book 0.2 rough cut is available [message #36888 is a reply to message #36854] Wed, 01 July 2009 10:14 Go to previous messageGo to next message
Henrik Lindberg is currently offline Henrik Lindberg
Messages: 2492
Registered: July 2009
Senior Member
Hi,
I am especially interested in comments about "The first thing that
confused me about Buckminster was...", and "I have still not understood
how to use XYZ..."

Does not have to be very insightful :)

Cheers
- henrik
Guillaume Chatelet wrote:
> Brilliant !
> Thank you so much for this. I'm sure this book will help *a lot*.
> I'll try to get back to you with insightful comments.
>
> Cheers and well done !
> Guillaume
>
Re: [buckminster-dev] The Bucky Book 0.2 rough cut is available [message #36922 is a reply to message #36888] Wed, 01 July 2009 11:41 Go to previous messageGo to next message
Johannes Utzig is currently offline Johannes Utzig
Messages: 329
Registered: July 2009
Senior Member
This looks fantastic. Thank you very much for all the effort you put in
this. I'll read it asap and get back to you if I have any comments.
Since you stated that you want some 'I still have not understood how to
use XYZ...' comments, here's mine:
I'm missing some mspec documentation and best practices on how and when
to use them.

Best regards,
Johannes

Henrik Lindberg schrieb:
> Hi,
> I am especially interested in comments about "The first thing that
> confused me about Buckminster was...", and "I have still not understood
> how to use XYZ..."
>
> Does not have to be very insightful :)
>
> Cheers
> - henrik
> Guillaume Chatelet wrote:
>> Brilliant !
>> Thank you so much for this. I'm sure this book will help *a lot*.
>> I'll try to get back to you with insightful comments.
>>
>> Cheers and well done !
>> Guillaume
>>
Re: [buckminster-dev] The Bucky Book 0.2 rough cut is available [message #36957 is a reply to message #36922] Wed, 01 July 2009 11:49 Go to previous messageGo to next message
Henrik Lindberg is currently offline Henrik Lindberg
Messages: 2492
Registered: July 2009
Senior Member
Johannes Utzig wrote:
>'I still have not understood how to
> use XYZ...' comments, here's mine:
> I'm missing some mspec documentation and best practices on how and when
> to use them.

I just started on the CSPEC/X chapter, but maybe I should do the
"Mysteries of MSPEC" first...

- henrik
Re: The Bucky Book 0.2 rough cut is available [message #37470 is a reply to message #36818] Sun, 05 July 2009 02:46 Go to previous message
Thomas Hallgren is currently offline Thomas Hallgren
Messages: 3208
Registered: July 2009
Senior Member
Henrik Lindberg wrote:
> ... And I think we will have a documentation category for Buckmisnter in the
> Bugzilla.
>
I've added a documentation component to out Bugzilla.

- thomas
Previous Topic:[buckminster-dev] Project meta data is out of date for tools.buckminster
Next Topic:[buckminster-dev] Newbie with ClearCase challenge...
Goto Forum:
  


Current Time: Thu Apr 17 03:45:30 EDT 2014

Powered by FUDForum. Page generated in 0.03359 seconds