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

Declaring the revision process over #18

Open
finanalyst opened this issue Dec 8, 2023 · 3 comments
Open

Declaring the revision process over #18

finanalyst opened this issue Dec 8, 2023 · 3 comments

Comments

@finanalyst
Copy link
Contributor

After finalising ideas prompted by @zag's suggestions, which included a more generic placement block, display texts for codes that can fail, and a new Formula block, it seems to me that the specification process for the language has come to a natural end.

The issue of signaling where customisations are to be found remains open, but can be considered an implementation detail at this time - IMHO.

Unless a significant new change is identified, I suggest the specification here can be moved to the Raku Steering Council for adoption.

@thoughtstream @Raku/docteam @Raku/core Any objections?

@thoughtstream
Copy link

There remains the issue of @zag's :checkbox proposal,
which I'll address in the separate thread.

I don't think we should pursue the more extensive "selector" mechanism
that @zag also proposed, as it seems to be tied closely to his Podlite design,
which has some fundamental differences from our RakuDoc approach.

As for @zag's W<URI> proposal, I'm still not sure I entirely understand it,
but it does already seem to be covered by: N<P<URI>>

So, apart from :checkbox, yes I agree that our redesign process has reached a natural conclusion
and (assuming we can quickly address the above issue) should be moved to the RSC for approval.

@finanalyst
Copy link
Contributor Author

generalisation of :checkbox incorporated. HTML rendering now visible at new-raku/rakudoc

@finanalyst
Copy link
Contributor Author

I've bumped the version to v2.4.0 to indicate final version. Further changes will be to remove work-arounds because we can't yet render RakuDoc v2 fully.

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

No branches or pull requests

2 participants