Skip to content

Conversation

@david-a-wheeler
Copy link
Contributor

No description provided.

Signed-off-by: David A. Wheeler <[email protected]>
@david-a-wheeler
Copy link
Contributor Author

@SecurityCRob - comments?

I did not try to edit best-practices.yml. I'm not sure what that yml file is doing. Is that the source & the README is generated? I don't see any code to do the generation. If the .yml file is generated from the README, then please run that tool. If they're edited simultaneously, well, yuck :-(. In any case, there should be a clear document somewhere what their relationship is.

Copy link
Member

@ctcpip ctcpip left a comment

Choose a reason for hiding this comment

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

this is great! looks good, just some minor corrections, and a few consistency suggestions as well

SecurityCRob and others added 6 commits May 21, 2024 08:48
fixes typo

Co-authored-by: Chris de Almeida <[email protected]>
Signed-off-by: CRob <[email protected]>
better word choice

Co-authored-by: Chris de Almeida <[email protected]>
Signed-off-by: CRob <[email protected]>
better word choice

Co-authored-by: Chris de Almeida <[email protected]>
Signed-off-by: CRob <[email protected]>
Copy link
Contributor

@SecurityCRob SecurityCRob left a comment

Choose a reason for hiding this comment

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

I like the addition. If we could get Chris' open comment resolved I think we can move this forward

@SecurityCRob
Copy link
Contributor

@SecurityCRob - comments?

I did not try to edit best-practices.yml. I'm not sure what that yml file is doing. Is that the source & the README is generated? I don't see any code to do the generation. If the .yml file is generated from the README, then please run that tool. If they're edited simultaneously, well, yuck :-(. In any case, there should be a clear document somewhere what their relationship is.

I think Randall put that in place. I'm also unsure how that works. We should ask him to start.

@balteravishay
Copy link
Contributor

@SecurityCRob - comments?
I did not try to edit best-practices.yml. I'm not sure what that yml file is doing. Is that the source & the README is generated? I don't see any code to do the generation. If the .yml file is generated from the README, then please run that tool. If they're edited simultaneously, well, yuck :-(. In any case, there should be a clear document somewhere what their relationship is.

I think Randall put that in place. I'm also unsure how that works. We should ask him to start.

I think that might relate to how the Legitify was used to produce these recommendations. maybe @noamd-legit can comment on this and suggest how to add new ones?

@noamd-legit
Copy link
Contributor

The best-practices.yml is generated automatically and does not require manual edits. In fact, I believe we can remove it entirely from this repository.

To update the document, simply edit the markdown file. If we need to regenerate the base version, I will handle any differences that arise.

@david-a-wheeler
Copy link
Contributor Author

In that case, I suggest removing the .yml file (in a separate pull request). We generally don't want generated files in the source repo.

@noamd-legit - would you mind creating that PR?

@noamd-legit
Copy link
Contributor

@david-a-wheeler
Removed the file here: #508

Co-authored-by: Chris de Almeida <[email protected]>
Signed-off-by: David A. Wheeler <[email protected]>
@balteravishay balteravishay requested a review from ctcpip November 5, 2024 15:34
@SecurityCRob SecurityCRob merged commit 95fd687 into main Nov 5, 2024
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants