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

feat: add nextVersion and untagged deprecations #82

Merged
merged 1 commit into from
Aug 29, 2020

Conversation

timdeschryver
Copy link
Collaborator

@timdeschryver timdeschryver commented Aug 27, 2020

  • Running without --nextVersion adds newly crawled deprecations without a version ("version": "")
  • Running with --nextVersion adds that version to the newly crawled deprecations
  • Running with --nextVersion adds that version to the previously crawled deprecations that are untagged

Partially #37

- /tree/master/all-lowercase/crawled.ts#L12
- /tree/master/all-lowercase/crawled.ts#L18
- /tree/master/all-lowercase/crawled.ts#L24
- :
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just see this, this probably has to be fixed 🤔
But this also raises the question if untagged versions should be included in the markdown output files.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice pr! I'll have a think on that!

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about giving it the "version" of the main branch until there the next tag arrives?

This most probably introduces more fiddly logic, so I'm not sure if this is a good idea,.
But at least we have the conversation about the problem ;)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think that's maybe too complex for now 😅

The current implementation of the group markdowns is that it will append new deorecations to the file, correct (meaning that you could make manual edits to the existing deprecations in the file, and it won't get overwritten)?

I also have a second question, does it make sense to have the checkout step?
I mean, if you go to a different branch, and you pass in a next version, that seems a little bit odd to me.
In my opinion (I could be wrong), we don't need the checkout step when we run the crawler in its normal mode. It will just crawl the current branch.
If we implement the history command, that's the command where we should use the checkout step (possibly multiple times).

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current implementation of the group markdowns is that it will append new deprecations to the file, correct (meaning that you could make manual edits to the existing deprecations in the file, and it won't get overwritten)?

It went to the top of the file and replaces the whole comment block with all the deprecations form raw-depreciations.
So whatever is done in the file stays untouched, but the comments are completely new. All edits in the comments are lost which is no problem as comments.. :D

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I also have a second question, does it make sense to have the checkout step?

No, but the last valid tag should get determined right?

How does it work in master? I can imagine in the output formatted we can replace empty versions with the main name?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh I see, you've merged this one in.
Just as an fyi, I've taken a closer look to the generated markdown and I agree with you 😁
I will create a follow up PR to add the main branch 😉

@BioPhoton BioPhoton merged commit d421a77 into master Aug 29, 2020
@github-actions
Copy link

🎉 This PR is included in version 1.11.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@timdeschryver timdeschryver deleted the pr/untagged-deprecations branch August 29, 2020 08:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants