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

update changelog for big restructuring #83

Closed
cholmes opened this issue Dec 7, 2020 · 5 comments
Closed

update changelog for big restructuring #83

cholmes opened this issue Dec 7, 2020 · 5 comments
Milestone

Comments

@cholmes
Copy link
Collaborator

cholmes commented Dec 7, 2020

We merged without updating, since we wanted to get everything into master.

@cholmes cholmes added this to the 1.0.0-beta.1 milestone Dec 7, 2020
@cholmes
Copy link
Collaborator Author

cholmes commented Dec 7, 2020

Made an attempt on this at a0453f5

Feedback appreciated @m-mohr / @matthewhanson

@cholmes cholmes mentioned this issue Dec 8, 2020
4 tasks
@m-mohr
Copy link
Collaborator

m-mohr commented Dec 8, 2020

I don't think it is complete, but it's a good start. It will be pretty hard to capture all changes correctly in a way it's helpful to devs as we made quite a lot of substantial changes.

@cholmes
Copy link
Collaborator Author

cholmes commented Dec 8, 2020

What else would you add? Happy to take another crack at it.

@m-mohr
Copy link
Collaborator

m-mohr commented Dec 8, 2020

Haven't looked into details, but there's not really many infos on how to approach changes as a dev. The changelog is quite high-level about some changes and thus you actually need to dig deep into the spec versions to know how to update from 0.9 for example. @joshfix once critizised that....

@cholmes
Copy link
Collaborator Author

cholmes commented Dec 10, 2020

I'm not sure how to actually describe this set of changes without people having to look at it and dig in. I get the point, but I think that works for iterative improvements where you can just scan and see what's most relevant. With this we've changed little in how it works, but implementations are going to have to figure out what they actually conformTo, and I don't think we can communicate that in the changelog fully.

@cholmes cholmes closed this as completed Dec 10, 2020
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