From c90a05d4408e6d5760806d5420375cbc2ed049f7 Mon Sep 17 00:00:00 2001 From: John Freeman Date: Thu, 5 Jan 2023 17:24:04 -0600 Subject: [PATCH] JCF: Issue #31: basic skeleton of how the rules are accessed from the homepage of our documentation --- docs/README.md | 4 +++- docs/developer_rules.md | 3 +++ 2 files changed, 6 insertions(+), 1 deletion(-) create mode 100644 docs/developer_rules.md diff --git a/docs/README.md b/docs/README.md index 1354a56ba55..912b965aecb 100644 --- a/docs/README.md +++ b/docs/README.md @@ -2,7 +2,9 @@ Welcome! The purpose of this website is to provide information on how to use the applications, plugins, base classes, etc. offered by the suite of DUNE DAQ packages. You can learn both how to run the DAQ as well as use various tools to extend its functionality. -If you're new to DUNE DAQ software, you'll want to start by reading the [daq-buildtools documentation](packages/daq-buildtools/README.md), which covers [how to set up a development environment](packages/daq-buildtools/README.md#Setup_of_daq-buildtools) and [build a package](packages/daq-buildtools/README.md#Cloning_and_building). Once you've done this, you'll likely want to learn about [how to write DAQ modules](packages/appfwk/README.md#Writing_DAQ_modules) in the [appfwk documentation](packages/appfwk/README.md), units of code which +If you're new to DUNE DAQ software and plan to do development, before your first keystroke please read the [developer rules](developer_rules.md). This covers personal conduct related to software development meant to minimize friction between developers, code reversions, etc. + +you'll want to start by reading the [daq-buildtools documentation](packages/daq-buildtools/README.md), which covers [how to set up a development environment](packages/daq-buildtools/README.md#Setup_of_daq-buildtools) and [build a package](packages/daq-buildtools/README.md#Cloning_and_building). Once you've done this, you'll likely want to learn about [how to write DAQ modules](packages/appfwk/README.md#Writing_DAQ_modules) in the [appfwk documentation](packages/appfwk/README.md), units of code which are meant to perform specific tasks and can be combined to define the overall behavior of a running DAQ application. At some point you may also need to learn about how to create a package from scratch by reading the [daq-cmake documentation](packages/daq-cmake/README.md); this documentation is also very useful for understanding how to get new source code files you've added to compile. There are six DUNE DAQ software packages which are used to aid diff --git a/docs/developer_rules.md b/docs/developer_rules.md new file mode 100644 index 00000000000..beb2a2b8af6 --- /dev/null +++ b/docs/developer_rules.md @@ -0,0 +1,3 @@ +# Developer Rules + +[Back to the DUNE DAQ software documentation homepage](README.md)