Commit Graph

8 Commits

Author SHA1 Message Date
Pablo Baeyens 8c24854960
[chore] Add naming guidance for modules prefix (#12479)
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

Add guidelines for naming Go modules
2025-02-25 22:40:14 +00:00
Pablo Baeyens c713e7c4d7
[chore][docs] Add guidance regarding breaking changes (#12274)
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

<!-- Issue number if applicable -->

Reworks breaking changes section to include information about our
approach to feature gates.

---------

Co-authored-by: Evan Bradley <11745660+evan-bradley@users.noreply.github.com>
2025-02-14 11:40:48 +00:00
Pablo Baeyens 1041a0be80
[chore][docs] Use consistent title hierarchy (#12272)
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

<!-- Issue number if applicable -->

Use h2 (hN-1) titles for h2 (hN-1) sections instead of h3 (hN)
2025-02-04 16:39:08 +00:00
Pablo Baeyens 1e5ccbecd8
[chore] Document module split in more detail (#11860)
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

- Documents when to split into separate modules, including general rules
as well as specific conventions we are currently using
- Rephrases the wording on #11836 to add it into a general list.
- Documents how to split into separate modules.

<!-- Issue number if applicable -->
#### Link to tracking issue
Follows #11836, Fixes #11436, Fixes #11623

---------

Co-authored-by: Jade Guiton <jade.guiton@datadoghq.com>
2024-12-23 16:37:55 +00:00
Dmitrii Anoshin 4a987da6c5
[docs] Add guidelines for experimental modules naming (#11836)
Adding guidelines for experimental module naming as a result of [the
vote](https://github.com/open-telemetry/opentelemetry-collector/issues/11783).

Resolves #11783
2024-12-11 16:26:23 +00:00
Pablo Baeyens 37184b0b3f
[chore][docs] Move configuration changes guidelines to component stability doc (#11572)
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

<!-- Issue number if applicable -->
Works towards #11553. Unifies information about component stability in a
single document.

#### Link to tracking issue
Fixes #11571
2024-10-30 15:55:05 +01:00
Pablo Baeyens 39f714b442
[chore][docs] Reflect current practices about configuration structs in coding guidelines (#11549)
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

<!-- Issue number if applicable -->

Reflects existing practice in coding guidelines.

#### Link to tracking issue

Relates to #6767, fixes #9428
2024-10-29 10:59:30 +01:00
Pablo Baeyens f2b31d131a
[chore][CONTRIBUTING.md] Move coding guidelines to separate document (#11484)
<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

<!-- Issue number if applicable -->

Moves coding guidelines to a separate document where we can work on
expanding them. This is the largest part of the contributing document
and it was making it a bit difficult to work with and scary-looking for
newcomers.
2024-10-21 11:39:51 +02:00