#179 Updates to Initiatives page, including removal of failing ref to attributes.adoc file
Closed by karl0sfandang0. Opened by karl0sfandang0.
Fedora-Council/ karl0sfandang0/council-docs main  into  main

I've made some first edits to the Initiatives page. Stopping here and creating this PR to check it's on the right track.
Signed-off-by: Karl Stevens karlosfandango64@gmail.com

I wouldn't say "typically aren't" here. The idea mix would be 50% engineering, 50% from the rest of the project. We rarely hit that ideal mix, but that's dream.

"this section" is no longer valid. Probably replace with an xref to the "Current Initiatives" section below and word accordingly.

I'd also explicitly mention that the Lead sits on the Council.

This paragraph starts with a sentence fragment.

It might be good to explicitly discuss the separation from technical leadership and organizational/project management leadership like we discussed. We could also mention that the Council will assign an existing member as an Executive Sponsor (and describe that role), but I'm not sure if it belongs here or elsewhere.

Good work @karl0sfandang0! I've left some specific comments above.

Generally, it would be better to format it one sentence per line (or SemBr...see below). AsciiDoc works like Markdown in that a single newline will not create a new paragraph. This makes changes much easier to review,

I also notice you kept a lot of the existing wording. That's fine if you like it. But also, if you think some of the wording is bad, now's a great time to propose improvements!

A note on Semantic Line Breaks (SemBr): Matthew is a big fan of Semantic Line Breaks (SemBr). This concept inserts line breaks at semantic boundaries. This makes diffs evern more useful to understand the meaning. Personally, I see the appeal, but I can't make myself write that way. Also, I think SemBr has an unintended side effect of enabling far-too-long sentences. So if you want to use SemBr, go for it! If not, I understand. It's not the official style, just a windmill mattdm tilts at from time to time. :wink:

As discussed with @bcotton. Closing this PR and opening a fresh one against a specific branch for Issue44, incorporating new edits based on comments above.

Pull-Request has been closed by karl0sfandang0

Metadata