Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [mdt-papyrus.dev] Rip Pdoc

Hello

May I have additional elements?

 

Why not use the description element in the pom.xml?

A detailed description of the project, used by Maven whenever it needs to describe the project, such as on the web site. While this element can be specified as CDATA to enable the use of HTML tags within the description, it is discouraged to allow plain text representation. If you need to modify the index page of the generated web site, you are able to specify your own instead of adjusting this text.

So we can generate better automatically site descriptor? And not duplicate basic documentation location.

 

I think we have to keep documentation as closed as possible to the artifact/plugin element and not to duplicate it across several place.

I could investigate more time on how to use the maven template project (mainly src/site with the site descriptor and the xdoc) ?

The key idea will be how to generate the actual site directly in the eclipse media wiki.

I will try to do it for the emfgen plugin (still in my branch, I will cherry peak it in the week).

 

Have a good day.

 

Francois

 

 

De : mdt-papyrus.dev-bounces@xxxxxxxxxxx [mailto:mdt-papyrus.dev-bounces@xxxxxxxxxxx] De la part de Christian W. Damus
Envoyé : lundi 12 janvier 2015 17:51
À : Papyrus Project list
Objet : Re: [mdt-papyrus.dev] Rip Pdoc

 

+1

 

Now I feel silly for having diligently added pdoc files to all of the new plug-ins I have contributed in Luna and Mars releases …  ;-)

 

Christian

 

On Jan 12, 2015, at 11:46, MAGGI Benoit <Benoit.MAGGI@xxxxxx> wrote:

 

Hi Team,

 

There is currently a sub project called “pdoc” in Papyrus.

It was intended to add some description for each plugins but was never widely used (less than 30 plugins).

The plugins are still in developer directory and are not deployed,  a newcomer won’t understand what these files are for.

 

I believe that we should use the Bundle-Description properties and add other information in the pom.xml.

(I already talked about that with most of the team)

 

So here are the next steps (for mars): 

-          Create a bug : https://bugs.eclipse.org/bugs/show_bug.cgi?id=457266

-          Remove all pdoc files and plugins from repository (The work is still on progress ) : https://git.eclipse.org/r/#/c/39401/

o   The description in pdoc will be moved to MANIFEST.MF\Bundle-Description

-          Add a text in the wiki to explain all of that.

 

If anyone is against it, “speak now or forever hold your peace” J

 

Regards

Benoit

 

 

_______________________________________________
mdt-papyrus.dev mailing list
mdt-papyrus.dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/mdt-papyrus.dev

 


Back to the top