VictoriaMetrics/docs/goals.md
Aliaksandr Valialkin 83d53dfb0d
Revert "replaced global http refs with relative markdown ones ()"
This reverts commit 537266363a.

Reason for revert: relative links in docs are much harder to maintain in consistent state
comparing to absolute links:

- It is non-trivial to figure out the proper relative link path when creating and editing docs.
- Relative links break after moving the doc files to another paths, and it is non-trivial
  to figure which links are broken after that.
- The updated relative links do not work properly right now in the docs.
  For example, the https://docs.victoriametrics.com/victorialogs/quickstart.md#building-from-source-code
  link at https://docs.victoriametrics.com/victorialogs/changelog/ leads to 404 page.

This is documented at https://docs.victoriametrics.com/#images-in-documentation .
2024-07-25 14:40:53 +02:00

4.0 KiB

sort weight title menu
500 500 VictoriaMetrics development goals
docs
parent weight
victoriametrics 500

Goals

  1. The main goal - to help users and clients resolving issues with VictoriaMetrics components, so they could use these components in the most efficient way.
  2. Fixing bugs in the essential functionality of VictoriaMetrics components. Small usability bugs are usually the most annoying, so they must be fixed first.
  3. Improving docs for VictoriaMetrics components, so users could find answers to their questions via Google or Perplexity without the need to ask these questions at our support channels.
  4. Simplifying usage of VictoriaMetrics components without breaking backwards compatibility, so users could regularly upgrade to the latest available release and remain happy.
  5. Improving usability for the existing functionality of VictoriaMetrics components.
  6. Improving the readability and maintainability of the code base by removing unnecessary abstractions and simplifying the code whenever possible.
  7. Improving development velocity by optimizing and simplifying CI/CD tasks, so they take less time to execute and debug.

Non-goals

  1. Convincing people to use VictoriaMetrics components when there are better suited solutions exist for their tasks, since users will become angry at VictoriaMetrics after they discover better solutions.
  2. Breaking links to VictoriaMetrics docs, since users will be unhappy seeing 404 page or unexpected results after they click some old link somewhere on the Internet or in the internal knowledge base.
  3. Breaking backwards compatibility in new releases, since users will be unhappy when their working setup breaks after the upgrade.
  4. Adding non-trivial features, which require significant changes in the code and the architecture, since these features may break the essential functionality of VictoriaMetrics components, so a big share of the existing users may become unhappy after the upgrade.
  5. Adding unnecessary abstractions, since they may worsen project maintainability in the future.
  6. Implementing all the features users ask. These features should fit the goals of VictoriaMetrics. Other feature requests must be closed as won't implement, with the link to this page.
  7. Merging all the pull requests users submit. These pull requests should fit the goals of VictoriaMetrics. Other pull requests must be closed as won't merge, with the link to this page.
  8. Slowing down and complicating CI/CD pipelines with non-essential tasks, since this results in development velocity slowdown.
  9. Introducing non-essential requrirements, since this slows down development velocity.

VictoriaMetrics proverbs

  • Small usability fix is better than non-trivial feature. Usability fix makes happy existing users. Non-trivial feature may make happy some new users, while it may make upset a big share of existing users if the feature breaks some essential functionality of VictoriaMetrics components or makes it less efficient.

  • Good docs are better than new shiny feature. Good docs help users discovering new functionality and dealing with VictoriaMetrics components in the most efficient way. Nobody uses new shiny feature if it isn't documented properly.

  • Happy users are more important than the momentary revenue. Happy users spread the word about VictoriaMetrics, so more people convert to VictoriaMetrics users. Happy users are eager to become happy customers. This increases long-term revenue.

  • Simple solution is better than smart solution. Simple solution is easier to setup, operate, debug and troubleshoot than the smart solution. This saves users' time, costs and nerve cells.