Add a clarifying first paragraph to Future.md #623
Conversation
| @@ -1,5 +1,7 @@ | |||
| # The Future of SARIF | |||
|
|
|||
| The purpose of this document is to list potential new areas for standardization. These are not guarantees. They are areas we are strongly considering for a future edition of the SARIF standard. | |||
There was a problem hiding this comment.
Suggestion: "These areas are not guarantees."
There was a problem hiding this comment.
This is part of what is there. Are you saying replace the whole paragraph and say only this?
There was a problem hiding this comment.
No, I'm saying to add "areas" after using the word "These" so that the reader knows what "These" refers to:
The purpose of this document is to list potential new areas for standardization. These areas are not guarantees. They are areas we are strongly considering for a future edition of the SARIF standard.
There was a problem hiding this comment.
Ah, thanks. Yes, that's a good suggestion. I read right past the word "areas" and didn't see it.
There was a problem hiding this comment.
Then I'd be using the word "areas" three times. I'll think of something similar.
There was a problem hiding this comment.
After thinking about it, the paragraph as a whole seems to work better the way it is, which avoids excessive repetition. If we had that sentence in isolation, then the change would work better.
|
@Motional-Charles-Wilson , @davidmalcolm : I don't know why github won't let me add you as reviewers, but I'd appreciate it if you would take a look. |
LGTM |
9524caf to
3a67461
Compare
|
Thanks for taking a look. I will go ahead and merge now. |
This was requested at the 2024-01-11 meeting.