So what worked quite well for the Eclipse NeoSCADA project is to use a static web page generated using the "Acceleo" Model to Text tools [1]. Checking in the static web pages in the web git repository and the sources to the generator to the "releng" code git repository. That way website and code was split up.
Of course you are down to coding manual HTML to some degree, although Acceleo helps a lot. If you use some sort of HTML toolkit (like bootstrap) you don't need to worry too much. Then again if you don't update your templates for a few years it starts to look old ;-) [1] https://eclipse.org/acceleo/ On Wed, Aug 17, 2016 at 1:17 AM, Mark Stoodley <[email protected]> wrote: > The OMR project is trying to work out what to do with our web site and > looking at a few options: > 1. web site sources in a directory in our GitHub repo (keep docs > and site beside code for easier maintenance) > 2. web site sources in a separate branch in our GitHub repo > 3. web site sources maintained at our Eclipse project web site git > repo > > In the first two cases, we would use a Hudson job to mirror the web site > source to our Eclipse web site repository and to generate the actual web > site, as I know some Eclipse projects already do. > > Just wondering if there are other options we should consider or > recommendations from other projects on what's worked best for you in > managing your web site / source code. > > In discussion on our mailing list, there is some attraction to maintaining > docs alongside the source code in the same pull requests as well as to be > able to branch the documentation along with the code for releases. There > are also concerns about binary artifacts and repository clone times if the > web site is in the same repository as the source code. I'd be particularly > interested if you have any advice on how impactful these issues have been > for your project. > > Thanks! > ------------------------------ > *Mark Stoodley* 8200 Warden Avenue > Senior Software Developer Markham, L6G 1C7 > IBM Runtime Technologies Canada > Phone: +1-905-413-5831 > e-mail: [email protected] > ------------------------------ > We cannot solve our problems with the same thinking we used when we > created them - Albert Einstein > > > > > > _______________________________________________ > incubation mailing list > [email protected] > To change your delivery options, retrieve your password, or unsubscribe > from this list, visit > https://dev.eclipse.org/mailman/listinfo/incubation > > -- Jens Reimann Senior Software Engineer / EMEA ENG Middleware Werner-von-Siemens-Ring 14 85630 Grasbrunn Germany phone: +49 89 2050 71286 _____________________________________________________________________________ Red Hat GmbH, www.de.redhat.com, Registered seat: Grasbrunn, Commercial register: Amtsgericht Muenchen, HRB 153243, Managing Directors: Paul Argiry, Charles Cachera, Michael Cunningham, Michael O'Neill
_______________________________________________ incubation mailing list [email protected] To change your delivery options, retrieve your password, or unsubscribe from this list, visit https://dev.eclipse.org/mailman/listinfo/incubation
