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

Better doc for abstract types #11234

Open
yuyichao opened this issue May 11, 2015 · 3 comments
Open

Better doc for abstract types #11234

yuyichao opened this issue May 11, 2015 · 3 comments
Labels
docs This change adds or pertains to documentation help wanted Indicates that a maintainer wants help on an issue or pull request

Comments

@yuyichao
Copy link
Contributor

While I was writing #11233 (and others) it comes to me that it is hard to figure out what functions are necessary in order to implement a subtype of an abstract type.

From the language itself, it is harder than other OO languages because the function doesn't belong to the object. methodswith helps a little but one still has to figure out what are relavant (and it has to be applied on subtypes instead of the parent abstract type).

I guess it might be very hard (if not impossible) to do it from the language itself but it would be helpful to document the exported types in Base at least. I'm not sure where/in what form is the best but I think it should answer the question: "What should I implement if I want to write my own Number/Range/etc. type"

@yuyichao
Copy link
Contributor Author

And this can help eliminating issues like #11049.....

@toivoh
Copy link
Contributor

toivoh commented May 12, 2015 via email

@jiahao jiahao added the docs This change adds or pertains to documentation label May 15, 2015
@jiahao
Copy link
Member

jiahao commented May 15, 2015

See also #6975

@StefanKarpinski StefanKarpinski added this to the 0.5.x milestone Aug 26, 2016
@StefanKarpinski StefanKarpinski added help wanted Indicates that a maintainer wants help on an issue or pull request and removed help wanted Indicates that a maintainer wants help on an issue or pull request labels Oct 27, 2016
@JeffBezanson JeffBezanson removed this from the 0.5.x milestone May 21, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs This change adds or pertains to documentation help wanted Indicates that a maintainer wants help on an issue or pull request
Projects
None yet
Development

No branches or pull requests

5 participants