Bugzilla – Full Text Bug Listing
| Summary: | Tutorial: Build your own DSL with Tools from the Eclipse Modeling Project | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Product: | Community | Reporter: | Peter Friese <peter> | ||||||||||||||||||
| Component: | Articles | Assignee: | community.articles-inbox <community.articles-inbox> | ||||||||||||||||||
| Status: | RESOLVED FIXED | QA Contact: | |||||||||||||||||||
| Severity: | normal | ||||||||||||||||||||
| Priority: | P3 | CC: | bernhard.merkle, Ed.Merks, jan, nboldt, richard.gronback, sven.efftinge, wayne.beaton | ||||||||||||||||||
| Version: | unspecified | ||||||||||||||||||||
| Target Milestone: | --- | ||||||||||||||||||||
| Hardware: | All | ||||||||||||||||||||
| OS: | All | ||||||||||||||||||||
| URL: | http://www.eclipse.org/articles/article.php?file=Article-BuildYourOwnDSL/index.html | ||||||||||||||||||||
| Whiteboard: | |||||||||||||||||||||
| Attachments: |
|
||||||||||||||||||||
|
Description
Peter Friese
Ed, can you comment on this proposal? Sounds cool to me! Created attachment 99268 [details]
Article (built with DocBook) as a zip
This is the article we proposed. As far as we are concerned, work is finished, so we would be happy to have it reviewed by someone (Ed? Rich?) and get feedback.
Jan helped writing the article. CC'ing. (In reply to comment #3) > This is the article we proposed. As far as we are concerned, work is finished, > so we would be happy to have it reviewed by someone (Ed? Rich?) and get > feedback. I'll try to review it by next week. I gave the article a read, and I think it's a nice introduction to Xtext. Very clear, and nice and short ;) Just a few comments: - No provided solution projects? - No mention of the Textual Modeling Framework (TMF) project, where Xtext lives (or, will live)? I expect you'll have to update the article when Xtext is from TMF and there is no oAW component in GMT? - Perhaps use "textual DSL" in the title? (In reply to comment #6) > I gave the article a read, and I think it's a nice introduction to Xtext. Very > clear, and nice and short ;) Thanks for your feedback! Indeed we intended the article to be short, so readers could consume it easily. Quite on the contrary to the "From frontend to code" article which is not for the faint of heart :-) > Just a few comments: > > - No provided solution projects? Good point. We will provide a solution project. Do you think it is worthwhile to provide the project in its various steps, or would it suffice to provide just the finished project? > - No mention of the Textual Modeling Framework (TMF) project, where Xtext lives > (or, will live)? I expect you'll have to update the article when Xtext is from > TMF and there is no oAW component in GMT? Absolutely. The article is geared towards the current Xtext implementation which is a part of oAW. As soon as we have a working version of the TMF flavour of Xtext, we need to (and will) update the article. I'd like to avoid confusing readers by mentioning two different versions of Xtext. > - Perhaps use "textual DSL" in the title? Good point. I will change the article accordingly and upload the updated version. Created attachment 99372 [details]
Updated article
I updated the article:
1) provide a sample project
2) change the title of the article to include "textual DSL"
(In reply to comment #7) > Do you think it is worthwhile > to provide the project in its various steps, or would it suffice to provide > just the finished project? I think the finished project is sufficient. (In reply to comment #9) > I think the finished project is sufficient. https://bugs.eclipse.org/bugs/attachment.cgi?id=99372 contains the finished project, as suggested by Rich. Are there more comments? If not, can we publish the article? I am starting my editorial pass and plan to put this live in the next day or so. If anybody has a problem with the article, speak up! Article can be viewed online here: http://www.eclipse.org/articles/article.php?file=Article-BuildYourOwnDSL/index.html I haven't added it to the database yet, so it's not listed on the /articles page yet. Please verify that the project information at the top is correct. The code is now in /articles CVS: :pserver:anonymous@dev.eclipse.org:/cvsroot/org.eclipse www/articles/Article-BuildYourOwnDSL Please submit changes as patches to this project. I've made some minor changes. FWIW, Eclipse 3.3 is not "aka Europa", but rather is part of the Europa Release train. Note also, that I've changed your build.xml file. Do you think the article needs to have more explicit instructions for obtaining the prerequisite software? Or is it enough to just point the reader at the oAW update site (assuming that they're aware enough to include the Europa update site in the process)? Created attachment 100478 [details]
mylyn/context/zip
(In reply to comment #12) > Article can be viewed online here: > > http://www.eclipse.org/articles/article.php?file=Article-BuildYourOwnDSL/index.html Looks fine to me. > Please verify that the project information at the top is correct. +1 > Do you think the article needs to have more explicit instructions for obtaining > the prerequisite software? Or is it enough to just point the reader at the oAW > update site (assuming that they're aware enough to include the Europa update > site in the process)? Well, I am biased, so the others should have a say. (In reply to comment #12) > Please verify that the project information at the top is correct. +1 > I've made some minor changes. FWIW, Eclipse 3.3 is not "aka Europa", but rather > is part of the Europa Release train. Note also, that I've changed your > build.xml file. Thanks a lot. > The code is now in /articles CVS: > > :pserver:anonymous@dev.eclipse.org:/cvsroot/org.eclipse > www/articles/Article-BuildYourOwnDSL Sorry, I cannot access this. What's in between "...org.eclipse" and "www/..."? > Do you think the article needs to have more explicit instructions for obtaining > the prerequisite software? Or is it enough to just point the reader at the oAW > update site (assuming that they're aware enough to include the Europa update > site in the process)? AFAIK, the Europa update site is only needed if the Eclipse SDK does not contain EMF. Please correct me, if I am wrong. Is there any SDK distribution without EMF? Regards Jan (In reply to comment #15) > > :pserver:anonymous@dev.eclipse.org:/cvsroot/org.eclipse > > www/articles/Article-BuildYourOwnDSL paste the first line in the CVS Repositories View. Then navigate to the second line HEAD > www > articles > ... I think we're good to go. Wayne, could you add the article to the database, so it appear on the /articles page? Nick, It would be good to include a link to this page in the documentation section. This one too: http://www.eclipse.org/articles/article.php?file=Article-Integrating-EMF-GMF-Editors/index.html I made a minor change to the abstract. The article has been posted on /articles, /resources, and on the home page. Can the authors send me (wayne@eclipse.org) their coordinates so that I can send some appreciation swag? I'll need your shirt size, mailing address, and a contact phone number. If you can provide a single address, that would be best (i.e. we can save some money). Created attachment 104138 [details]
Corrected copyright strings.
Just a slight update. The copyright strings had to be changed, since "itemis labs Kiel" is not a legal entity.
Created attachment 104139 [details]
mylyn/context/zip
a few improvements for this great article... please add information _when_ to restart eclipse. there is already one location (after building the plugins), however in the subsequent course of the article it is a bit unclear when I have to restart. e.g.: After "Refining the DSL" (adding function "completeDataType_name") I had to restart. Necessary ? After "Defining constraints for your model" (adding constraint context Type ERROR) I had to restart. Necessary ? Wayne, we updated the copyright informtion in the article to match legl requiements (it has to read "itemis AG"). Could you update the article on the website during your next editorial run? Thanks! Company name has been changed on author entries and on copyright. Do you intend to address comment 22? Or can we close this? Created attachment 108318 [details]
Make article Ganymede ready
- Replaced deployment with start of new Eclipse Workbench which works since 3.4
- Use Ganymede instead of Europa
Please be more explicit. Should I replace the current version with this one? Have all the other recent changes been folded in already? All changes are provided as patches. It looks like all but the last patch https://bugs.eclipse.org/bugs/attachment.cgi?id=108318 have been applied. Could you apply that patch and update the article? Thanks in advance. The new images didn't come across in the patch. Can you attach them separately? Created attachment 112989 [details]
Additional images
Sorry for the very late reply. Here are the images.
Committed in HEAD. Should be live now. Marking as FIXED. Created attachment 113157 [details]
mylyn/context/zip
|