Spec work: logical model, terminology, configuration classes #151
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
|
As of 9:52 PM PST on Wednesday, February 1, 2023, here are some HTML files resulting from this draft PR so far that are much easier to read than the garbage that Github produces from an Asciidoc file: |
Signed-off-by: Laird Nelson <[email protected]>
|
As of 2:35 PM PST on Thursday, February 2, 2023, here are some HTML files resulting from this draft PR so far: |
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
|
As of 8:20 PM PST on Wednesday, February 8, 2023, here are some HTML files resulting from this draft PR so far: |
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
Signed-off-by: Laird Nelson <[email protected]>
|
As of 3:04 PM PST on Thursday, February 9, 2023, here are some HTML files resulting from this draft PR so far: |
… specification Signed-off-by: Laird Nelson <[email protected]>
|
As of 8:32 PM PST on Thursday, February 9, 2023, here are some HTML files resulting from this draft PR so far: |
|
Closing this PR in favor of #170 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This is a PR related to:
This PR is the result of my assignment from the Thursday, January 26, 2023 Jakarta Config meeting to try to formalize some of the existing work around the logical model of configuration we have mostly agreed on, the terminology involved, and the requirements around configuration classes (interfaces) (expressed in the Agenda and Minutes as "Laird is to take a look at the config mapping to see whether it fits in with loader"). You can look at our discussions area for other information that is incorporated into this PR.
This PR also makes the Asciidoc toolchain just produce individual HTML documents for now, as agreed on our Thursday, February 9, 2023 call. It is easier to proof and draft this way. Obviously in the distant future when the specification begins to coalesce we will revisit this.
There will be other PRs in this spirit; this is just the beginning. However, I hope this PR finally establishes some rigorous language we can use to talk about this project.
I strongly, strongly urge you to look at the HTML contained within the attached tarballs (see comments), since Github's previewing of Asciidoc is uniformly terrible.