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

A language spec ! #28

Closed
crlf0710 opened this issue Jan 18, 2018 · 6 comments

Comments

Projects
None yet
2 participants
@crlf0710
Copy link

commented Jan 18, 2018

An (even incomplete and informal) language specification document can help people understand the concepts and details of the language. It will aid the documentation of libstd in many ways.

@ErichDonGubler

This comment has been minimized.

Copy link
Collaborator

commented Jan 18, 2018

Just to make it clear, I'm assuming you're talking about the Rust language (since it wasn't explicit, but seems pretty obvious).

An initial search yields:

@ErichDonGubler

This comment has been minimized.

Copy link
Collaborator

commented Jan 18, 2018

What exactly are the use cases? I know that there's several, and I'm more than happy to do some research myself, but I want to hear it from you. I've already heard one, though I think it could use some more concrete detail:

It will aid the documentation of libstd in many ways.

How will it help document libstd? What users does this serve, and why is it important to them?

@crlf0710

This comment has been minimized.

Copy link
Author

commented Jan 18, 2018

An initial search yields:

There's also a reference too: https://doc.rust-lang.org/stable/reference/

@crlf0710

This comment has been minimized.

Copy link
Author

commented Jan 18, 2018

How will it help document libstd?

Sorry for my bad english, i meant it will complement the current libstd documentation, and give a more general and central "once and for all" introduction of the concepts and ideas for all those language items. The process of developing it will also clean up the technical vocabulary (and slang) and help resolving the ambiguities in description around Rust the language, It may also clarify many if not all the corner cases, and help the development of a test suite. i believe it is important but not urgent.

@ErichDonGubler

This comment has been minimized.

Copy link
Collaborator

commented Jan 26, 2018

So far as I can tell, the Rust reference is incomplete at this point because the language is unstable. This seems largely out of the control of library authors, and something that would definitely be a priority for the Rust community (which I imagine would have a call for participation) years from now, when there's more stability with Rust in general.

I guess what I'm saying is I'm not sure if this item really has a place on this list because I don't see that it's very actionable -- does that make sense? If we can break this down into tasks of some sort, I might be happy to discuss this, but as things stand, I'm planning on closing this this coming Tuesday if no further discussion happens here.

@ErichDonGubler

This comment has been minimized.

Copy link
Collaborator

commented Jan 30, 2018

No more discussion has been had, so...closing this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.