Action-TC-2018-17 create rules supplement on approach to technical standards

[jude2018]

Per TC in Helinki - no specific standards set. It is possibe to have specific standards, so in situation where there are multiple projects, all projects are doing the same.

The developed standards could be a supplement to the technical rules

Please note #449

[benjaminsaclier]

What do u think about replacing the Code Style section of "Technical rules" by something more generic including several languages ? We don't need to "reinvent the wheel" we may referring for example to Mozilla association code rules https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Coding_Style which including most languages: Python, Java, C...

[benjaminsaclier]

Regarding standards I am concerned that it is something who can discourage potential candidates to join the association. We could not organize a very small project like Excel2wis in the same manner and with the same tools than for example Openwiscore. In Apache association they let people free : The board does not provide technical direction for any of its projects or activities; every PMC is free to manage its technical direction independently. PMCs are the governing body for their project, and are expected to manage the project's technology in the best interest of the whole project community, independent of outside commercial influence.

What is your point of view ?

[solson-nws]

Reminder for each TC member to review Benjamin's proposal to use the Mozilla website as template for our coding standard/style.

https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Coding_Style

Benjamin also proposes that the board doesn't provide technical direction. Specifically, Benjamin states: The board does not provide technical direction for any of its projects or activities; every PMC is free to manage its technical direction independently. PMCs are the governing body for their project, and are expected to manage the project's technology in the best interest of the whole project community, independent of outside commercial influence.

During our discussions, a path forward wasn't clear. Further comments are needed on this. Please comment on this.

[jude2018]

Per TC in Septemberr 2018. Agreed that further from TC members is required before deciding whether:

• a change to rules is required and/or
• Rule can flexible, depending on the project

[solson-nws]

Additions needed to close this ticket:

1. Add how the PMC describes which coding styles they will use for the project
2. Links to examples of each coding styles
3. Metadata templates for the coding styles

@StephanSiemen @mgiannoni @benjaminsaclier @mvisa : Can you add artifacts to this issue?

[solson-nws]

4. every PMC is free to manage its technical direction independently, subject to approval from SC.

[jude2018]

@solson-nws @benjaminsaclier is any changes to the website needed regarding the approved iems above?

[solson-nws]

The openwis Website needs to be updated before closing

[solson-nws]

Actions:

1. Pull out project delivery section from Project Governance webpage
2. MF to update ticket with eclipse tool/module (Code formatter)

[solson-nws]

Actions:

Pull out project delivery section from Project Governance webpage (@benjaminsaclier @solson-nws ) MF to update ticket with eclipse tool/module (Code formatter) (@davidpodeur @benjaminsaclier )

[solson-nws]

Reminder on needing to add these artfacts:

Additions needed to close this ticket:

Add how the PMC describes which coding styles they will use for the project Links to examples of each coding styles Metadata templates for the coding styles

@StephanSiemen @mgiannoni @benjaminsaclier @mvisa : Can you add artifacts to this issue?

[jude2018]

Per TC of 19 May 2020 - One area of change is to pull out the project delivery section to focus on new projects as this needs an update. @benjaminsaclier and @solson-nws in process of editing by adding examples.

[jude2018]

@benjaminsaclier and @solson-nws any update >

[jude2018]

@benjaminsaclier and @solson-nws - please add a target completion date to enabling tracking and monitoring

[jude2018]

Per annual TC on 11 May 2021 @solson-nws to speak to the OpenCDMS Project (Ian) regarding potential changes to technical rulesand document why (if any) different rules are being adopted.