MathHubInfo / Legacy-localmh

DEPRECATED - A cross-repository administration tool for the local authoring in MathHub.info
1 stars 0 forks source link

Implement (and release) the new generated content branches #304

Open tkw1536 opened 8 years ago

tkw1536 commented 8 years ago

/cc @m-iancu @kohlhase

m-iancu commented 8 years ago

Just continuing the discussion. After discussing with @florian-rabe we agreed to have 3 branches:

  1. master (for backwards compatibility) can have any generated content is needed for that archive (or none at all) -- e.g. florian might want to commit and version some generated files for experimental archives. 2.sources which is versioned but contains only sources, can be used by users or systems which generate their own content (e.g. MathHub) 3.generated which is unversioned (force-pushed) and has all generated files (and sources) for a complete deploy-able version. Can be given to externals to quickly have a running system.

A lot of branch management can be done just by adequate .gitignore (ignoring the correct folders for sources and master branches). For the rest we need lmh support. I started a template archive at https://gl.mathhub.info/meta/template based on the lmh none template.

tkw1536 commented 8 years ago

I would recommend against having any branch that is both versioned and has generated content on it (i. e. master) as this would increase the repository size dramatically. I would suggest we only have sources and generated. The people who really need generated content can just use the generated branch.

m-iancu commented 8 years ago

As mentioned above, master is only for backwards compatibility and @florian-rabe prefers it for specific archives. That makes transition easier, without breaking existing workflows. Otherwise I agree in principle we should slowly move away from that. But there are archives for which generation takes a lot of time/effort and only have a new version once a year, so versioning each of them might not be a bad idea.

kohlhase commented 8 years ago

I agree, space is cheap. Let's go with this setup for now.