Skip to content
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

Separate build and input files #66

Open
JamesMBligh opened this issue Nov 14, 2021 · 1 comment
Open

Separate build and input files #66

JamesMBligh opened this issue Nov 14, 2021 · 1 comment
Labels
enhancement New feature or request

Comments

@JamesMBligh
Copy link
Contributor

Description
To allow for better visibility of the changes between different versions of the standards it may be advantageous to separate out the scripts and tooling used to build the publishable version of the standards and the raw input swagger and markdown files that actually make up the standards themselves.

Related Work Items

  • Separate out the build tooling into a separate repository so that only the raw input files remain in standards and standards-staging
  • Create a github action that to can be used build the publishable version from the raw files for remote publishing
  • Create a build script that can be used to build the publishable version from the raw files for local review
@perlboy
Copy link

perlboy commented Nov 14, 2021

It is unclear how separating build tooling from the source aligns with commonly adopted engineering practices. It's also unclear if this is even possible as the Standards currently intermingle build with spec. This approach appears to be the inverse of what has been requested and doesn't appear to have community support for doing so.

Once again, as a member of the community, I oppose this change.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants