Opened 6 years ago

Last modified 4 years ago

#1039 new enhancement

Web-based documentation should be automatically updated

Reported by: Ian Hinder Owned by:
Priority: minor Milestone:
Component: EinsteinToolkit website Version:
Keywords: Documentation Cc:


We have documentation for Cactus and the ET on their respective websites. This should be updated automatically when the source is changed, so it is never out of date. There should be documentation for the current release as well as the current development version.

There is one technical problem standing in the way of this. The system should be automated, and it needs to have commit rights to a specific directory in the SVN repository hosting the files. SVN accounts for CCT machines tend to be the same as CCT login accounts, so we don't want to store the username and password. I think the best solution is to create an SVN account specifically for the documentation build system which is not tied to a CCT login account. This account would be given commit access to just the directories necessary.

The "checkout, build doc, commit" script should be kept in version control somewhere, and a machine should be chosen on which to run it. It could be run regularly, or just in response to commits.

Attachments (0)

Change History (2)

comment:1 Changed 6 years ago by Frank Löffler

We could always point people to the repositories itself, as long as we keep the pdfs in there and the uploader did actually build a new version (which I hope they did, as they should test what they upload). The downside is that you might often get conflicts on the pdfs. On the other hand, they are very easy to solve.

comment:2 Changed 4 years ago by Frank Löffler

Ian - please let me know if the login-info I've sent you works. For others: there is now an account that can be used to automatically push to the ET website.

Modify Ticket

Change Properties
Set your email in Preferences
as new The ticket will remain with no owner.
Next status will be 'review'.
as The resolution will be set.
to The owner will be changed from (none) to the specified user.
Next status will be 'confirmed'.
The owner will be changed from (none) to anonymous.

Add Comment

E-mail address and name can be saved in the Preferences.

Note: See TracTickets for help on using tickets.