-
Notifications
You must be signed in to change notification settings - Fork 47
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Use main instead of to dev/master #308
Use main instead of to dev/master #308
Conversation
The second part of this that @cholmes brings up is that we should really convert this spec from intending to be a set of markdown docs in github to a generated website (e.g., like tools like Sphinx do). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good, added a suggestion to be more clear in the readme, to help non-developers understand what's going on. And like you mentioned I definitely think we should move towards a 'publish' step. The new stac website may offer some way to do it, but that's beyond my website & CI skills.
Co-authored-by: Chris Holmes <[email protected]>
I took a brief look at eleventy (the static site generator that's being used for stacspec.org) and was able to generate a site from the spec, though it didn't have any styling and most of the links were subtly wrong. But, I think it is feasible to use this to generate websites for stac-spec and stac-api-spec that we can publish, we just need to put a bit of work into it. |
Related Issue(s):
Proposed Changes:
Change branch strategy to use main w/ tags instead of dev/master.
Former PR here: #268
There are two aspects to this change:
dev
branch was a rapidly-changing work-in-progress. It made sense to not make this the first thing people saw when they came to this repo. As we converge towards 1.0.0, there will be fewer significant changes in main that are not part of the latest released version. Most repos don't have master or a branch with their latest released version as the default branch, so users are used tomain
being the development tip.References:
PR Checklist:
stac-spec
directory (these are included as a subtree and should be updated directly in radiantearth/stac-spec)