Fix few obsolete references to P in release notes

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I5bd73ae00d770b258a0343d3ae6aae1d4b92193a

Update download page for Sulfur SR0

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: Ibfcde481a9dddeff3af2ca13210282f3a61721fe

Update Sulfur release notes

MRI projects have been updated, reflect that in the release notes.

Change-Id: Ibc5dbe11a4f135705a5843eef4e33dd4932660ad
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Expend InstanceIdentifier migration section

InstanceIdentifier now requires constructs inherited via the use
of a top-level grouping at module top-level to be properly qualified.
Documentat that requirement.

Change-Id: Ifb260d43764a44cd8f90bf8343b54ae300dad803
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update MRI projects' versions

Update upgrade notes and fixup verisons in release notes.

Change-Id: I5b3ed63eb888accc3f8b76d7c940ea5090063cff
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Use sphinx keep-going option in tox jobs

Without this option, sphinx stops at the first warning found
when -W option is enabled.
This prevents users from troubleshooting their contributions in 1 pass.

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: Idf3cbea031fd9b6be63cbdbdc95620d3ba18b7ff

Update platform upgrade guide for Sulfur

Update the documentation to reflect the changes made to the platform.

Change-Id: Id4c012c9ec7501735cee93611d177cfe0b91a7d2
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update MRI project release notes

Update the JIRA links and general outline of release notes to sum up
changes delivered in Sulfur.

Change-Id: I0e42a75ba28bcfe22625042a8b3e41e8f51dc262
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Document maven-3.8.3 as the minimum version

Sulfur requires a newer version of Maven to build, update the
documentation accordingly.

Change-Id: I09bf9a2795094f434d4024a237a376b5212390b0
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Fix project & version for Phosphorus

OpenDaylight documentation site for Phosphorus currently shows
'transportpce' & 'stable-phosphorus' as the project name & version,
respectively, instead of 'OpenDaylight Documentation' & 'Phosphorus'
as configured in conf.yaml because global variables 'project' and
'version' are overridden while 'intersphinx_mapping' is getting
updated.

Move the for-loop to update 'intersphinx_mapping' inside a function
to prevent the global 'project' & 'version' variables from being
inadvertently updated.

Change-Id: I9a418f29f8d5710c822985bbfe7e7c62743bc46b
Signed-off-by: Sangwook Ha <sangwook.ha@verizon.com>

Fix: Update self-service branch lock/unlock

Update the docs with how to self-service branch lock/unlock.

Change-Id: Ic482755451983f01e02ba4101ce5a5102abd9a35
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>

Intersphinx projects references refactoring

- use one TSV file for all projects
- use this file in docs/conf.py
- adapt RST reference names accordingly
- use one script to activate all projects
- use /bin/sh shebang for this script since it uses no bashism

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I4f18e41f3615803a1b7ba020ad27b9902454f158

Improve RTD projects branches activation

Some projects branches need to be manually activated by docs maintainers
with a script and a RTD personnal token.
This is especially true for MRI projects
Though, the current script only allows MSI projects activation.

- remove MRI projects from the old script mostly targeting MSI projects
- create a MRI projects versions list in TSV format
- copy/paste old script and adapt it quickly and dirtily
  to activate and build MRI projects branches

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: Ia9fa2c61c012970398d204196d5be78925374c34

Fix conf.py objects.inv references

-remove genius and opflex from the list
-fix past and current ODL release references

Issue: IT-23601
Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: If9222e0d539055180316b78d7dfc559db76843ed

Update download page for P SR2

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I9397d86a0c0c649e60592309a6610abf75e7144e

Remove Genius documentation link

Genius has not had a patch contributed in 19+ months and has been
not seen a release beyond Aluminium SR4. Deactivate its documentation
link.

Change-Id: Id4a13463069ac8dc99121e95c0ecdc871464cdfc
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Fix version parsing

A slight mistake crept it, fix the reference we are parsing.

Change-Id: I35f4cfc2bc5f30360aa48ead1ca097795df0a337
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
(cherry picked from commit f3a2cece5c72f04ce3ad231d23ffcafd1a4a0be7)

Fix odl_jira version comparisons

We cannot just compare versions as strings, as that breaks on
"0.14.8" <= "0.14.10". Add a bit of machinery to deal with the two
differing matches.

Change-Id: I7a1e5e6d49b472304237094784a3fe3ebb71971a
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
(cherry picked from commit 40b609c33f5cfdddad68678a50ab75fea4d21ee0)

Update INFO.yaml committers list

Issue: IT-23601
Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I140a56ce536f95e57d7314862c27c9aa052a14e4

Update download page for Si SR4

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I508f6624afe96a5164d25e91f2fbc27aa0e16ef0

Update TransportPCE P-SR1 release nostes

- Summarize new functionality brought by P-SR1
- Add the list of transportpce  commits integrated in P-SR1

JIRA: TRNSPRTPCE-565
Signed-off-by: Gilles Thouenon <gilles.thouenon@orange.com>
Change-Id: I4eb4e03c3a84d610eae6ff1687886d8429545cd8
(cherry picked from commit f573cc2515205f3dd6c36833b5bb8da156d99a8a)

Bump MRI project's release notes

Bump versions referenced by release notes to adjust for Phosphorus SR1
state of affairs.

Change-Id: Id02d32a056429983893d064a444e151496ef363f
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
(cherry picked from commit 5ef9d3d8d92b30e80423c899fd1e8b253894c974)

Update release notes for Phosphorus-SR1

Signed-off-by: jenkins-releng <jenkins-releng@opendaylight.org>
Change-Id: Ic47b49011c9ef1534611f324f27e4ebeafb29611
(cherry picked from commit 72a334124c5ea7e8344942078162d5bad9f2b125)

Update download page for P SR1

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: Ia57e2cf390aac48a42a40fed9cab3e26b6a42af7
(cherry picked from commit 0b36e701b0441e7d4254b7c79bfb6ca158d36fb8)

Update download page for Si SR3

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I9394ccec4a57136031e949b6297f35e06be34268

Docs: Update PATCH_URL pointing to S3

Nexus LOG shipping has been decommissioned and the
generated link is no longer valid.

Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
Change-Id: I7acfa78bf4acffc3fd38a66f2fc08431b239fd66

Fix release announcement links

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I53c85707d68c3d9272f6a4d9b90c8292afee842a

Update release schedule for Sulfur, P SR1 & Si SR3

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I06c2166dbe2f7e90f3dd202db6a0b833a119ef6a

Update TransportPCE release notes

- Update filter for issues resolved/known for Phosphorus
- Update other paragraphs

Signed-off-by: Gilles Thouenon <gilles.thouenon@orange.com>
Change-Id: I9e4b6a7a63dc0c017e82eae94448928251705b07

Update download page for Phosphorus

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: Ib19e88cde15971e9ed0ce19f7e5f34f654a37e4b

Update NETCONF release notes

The overview misses a number of things, make sure to update it with
OpenAPI and RESTCONF references. Also highlight netconf-2.0.x changes
and sum up the issues.

Change-Id: Ia97955380dcf0cfc39bb947124825d35573c07fd
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Fix fixVersion/version confusion

In the table of known issues we have fixVersion as the last column,
not affected versions.

Change-Id: Ic85a7609553fd2c667dfd2c3e97f858451fda03e
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update yangtools release notes

Correct the memory estimate and mention the ability to retain
statement source references.

Change-Id: I7ec877cee6eb6afae4d9da3a97aa1853db383ae1
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Fix infrautils version range

Fix my confusion between infrautils and netconf versions -- infrautils
is at 2.0.6, netconf is at 2.0.5.

Change-Id: I80cb1227d4efd7894bb95734756176dbee45a1a7
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Merge "Add MD-SAL release notes"

Merge "Add yangtools release notes"

Merge "Update infrautils release notes"

Merge "Update aaa release notes"

Merge "Fix JIRA directives for empty query results"

Merge "Add a JIRA filter link to generated tables"

Update infrautils release notes

Sum up the changes made in infrautils-2.0.x and provide a link to
issues.

Change-Id: Id0c6cb8dc1c209266f0af555eb3efc413cbb4e78
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update aaa release notes

Use our JIRA macro and document nothing has changed.

Change-Id: I922f651e5cea065bd6d99060d3479fc51bd847b1
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Fix JIRA directives for empty query results

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I1ce0b8f2fba38a8a42a6c43566e4307adc214196

Document our JIRA integration extension

Provide a reference on how to use the extension.

Change-Id: I37716be4ca28fd84b50d1588fe9361a84ff5caec
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Add a JIRA filter link to generated tables

Our tables are a mirror of what JIRA exposes through filters and while
this view cannot be directly embedded, provide a link for readers to
jump to JIRA and see the current view of the filter.

Also clean up internal structure to reduce code duplication.

Change-Id: I808dfae3bdbcaa2d65d58079e6189611a96801da
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Integrate datatables.net

The tables we generate for JIRA issues are static and ugly. Let's bring
some dazzle to them with datatables.net, which allow for sorting,
searching, pagination and a ton of other stuff.

Change-Id: I03a7efa184801aa009dc83c77970d998ce47c6ca
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Add MD-SAL release notes

There was quite a bit of churn in md-sal, sum up the most visible
changes.

Change-Id: Ic0be8cb9d637e7b567e2f4b8c45f829ec5928144
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Add yangtools release notes

Add a summary of changes integrated with yangtools-7.0.x

Change-Id: I887be9b00a57de7aedd6415105d82a6044403b3e
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Merge "Fix Java code style references"

Update BGPCEP release notes

We have 0.16.6 out and we also want use our Jira extension.

Change-Id: I42789c89e58ef9f4211e98f9ed6d2e63adb36f62
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Merge "Extract JIRA issues"

Merge "Check enchant-2 exec presence in tox spelling job"

Extract JIRA issues

We want to capture a table of JIRA issues for a number of MRI project
versions.

Nothing in upstream fits the bill, so we introduce our own Sphinx
extension, which uses the jira module to extract information from JIRA
and embed it into our RTD site.

Since there is no spell checker running on JIRA, we exclude files in
release-notes/projects/ from the Sphinx spell checker.

Change-Id: I5b0ac293dca2442776753078dbd1c79a52684677
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Fix Java code style references

code.google.com was migrated to github, update links.

Change-Id: I7dc1660e48df8d8d81c03b27ca75ac4d3331e92d
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Check enchant-2 exec presence in tox spelling job

enchant-2 has superseded enchant (v1) in recent GNU/Linux distributions
such as debian 11.
We do not need to ask enchant installation if enchant-2 executable is
detected on the system.

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I8b453534934737bdd11ba4e22cdf5b3e6ae62474

Update bgpcpep version

We have 0.16.5 integrated, make sure we update the filter.

Change-Id: I406ab9a443f9e68bb7686c60aef2ef3aa723cc8b
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update controller release notes

Sum up the changes delivered in Phosphorus release train.

Change-Id: Id5d693ea8fc3b32d9ce2b12e90247be2a0d352a6
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update upgrade notes

We have a few newer versions, plus one more breaking change. Document
them.

Change-Id: Ie8c6262e7c8cff2cdc8c50cdc9b11465fa04d2d6
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update bgpcep release notes

Update the filter for issues resolved in Phosphorus stream and highlight
the single breaking change.

Change-Id: I0c424b0d73c5df50d27ae5a31f3db73944759136
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update download page for Silicon SR2

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: Id59c39f940a6d3549960fddb6586820b8f875463
(cherry picked from commit e07060e03c5c375b72787a7e30cdc899febfddbf)

Fix release notes index

Signed-off-by: guillaume.lambert <guillaume.lambert@orange.com>
Change-Id: I42e1f49110c5d3bc64abbb80d92aa2cd86feccb6
(cherry picked from commit 03ce9a05a132fbd440edec715b92f9f68de091de)

Update upgrade guide

We have new platform versions, update references to them.

Change-Id: I1f46c17b20de3077bfd2ba309eaf5cb08d62e9d7
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Merge "Update Setting Up Clustering with Akka artery"

Update Setting Up Clustering with Akka artery

The migration away from legacy akka remoting to artery tcp.
Update Setting Up Clustering topic.

JIRA: DOCS-141
Change-Id: Id64b4861968637ab979345229ce9ceee580027dc
Signed-off-by: Kostiantyn Nosach <kostiantyn.nosach@pantheon.tech>
Signed-off-by: Ivan Hrasko <ivan.hrasko@pantheon.tech>

Update MRI versions

Reflect MRI versions for netconf-2.0.2.

Change-Id: Ibeeccfe126b686a22408394de4e62124c0e746f8
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update a missed reference

We are upgrading to Phosphorus, fix that.

Change-Id: I9a6d6f7ec2fd56cee90e22c40bffe089e71c1968
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Add a section on YANG Tools leafref resolution

The implementation of leafref resolution functions has been corrected
and it is catching bad path specifications. Document this change in
behaviour.

Change-Id: I96dabd4fd046388d11309119367a41907cc0b871
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Clean up upgrade process a bit

Fix a few spelling and formatting mistakes.

Change-Id: Ib52ea8db6179c1ba08676bf25246f355f17fc099
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update Phosphorus NETCONF reference

We have a regression in netconf-2.0.0, update the upgrade guide
to reference fixed-up netconf-2.0.1.

Change-Id: If1b5a547a6d15c449de94e99fd6130ed54518dfd
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update platform upgrade guide for Phosphorus

The platform is changing in a number of incompatible ways, shedding
a lot of code which was unused or has been provided only for backwards
compatibility. Update the upgrade guide to highlight these.

Change-Id: I53afd65b51386a082201f4cbda5bf5bea67c571a
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

Update releases downloads and schedule

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Ic7256ae8e6f8d8a7afb326bf1ff126388466aadf

Update releng IRC documentation URL

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Ic0b963d97decf40cc13774eb724b2cd476750b4f

Ignore spelling warnings in release notes

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I013e6636adaf29273b37367d260d997272531ad1
(cherry picked from commit 395054fcee73d40a88f9e3b73740cef819d554fd)

Update IRC chat locations

Freenode IRC channels locations are no more reachable.
Official OpenDaylight and LFN channels have migrated to Libera.Chat.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I6bf69adb168630ea31ae7f447ffa7b6399375264

Update INFO.yaml IRC chat locations

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: If33fb1605c09742ac2c83b9d8cf17f1b171f410f

Check Silicon official page in docs-linkcheck

The Si official page has been published and should not be ignored by
docs-linkcheck anymore.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I910fd5733714a66a78e4309d17f7016ca25175c2

Enforce Spellchecker in CI

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I7b4d8e69045b730fb9c59decae29922268564fa3

Rework Java coding guidelines

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Iff204a17b5a0cc4a3c6bae0399776ca4947f041d

Rework newcomer contributor guide

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I6b8ff34cb2b7ab406e728cd3eb90fa1bc69f21b5

Fix more and more spellchecker warnings

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I085785e937d72db050dc839ad33c56b9ee8354a4

Rework logging subsytem documentation

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Ica010170bfb6d8fe058515031dbda01ff24b13a3

Rework developer guide for Neutron

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I5d5a3a56c47568db78f7f841752cacbabe25d0ae

Rework odl-parent developer guide

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I92d033ae2e5530595248c2ee4d214a4d29095932

Rework tests component developer guide

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Icf1c199b2d79ced0d66e15dcde9a1a46964a07f2

Rework developer guide considerations

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I06d99ff21b9c4d197dde1e667ab435e1d3a8391f

Rework JUnit developer guide

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I1af7b1140ef3836c7c4496e4e337fb44ffb6cda6

Rework Yangtools developer guide

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Ia28a67442f4571f2ecd8ce44b1a6a052a7519731

Rework docs documentation

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Ia8f577b2c07748db6290ea67937d78ce1fe774b9

Fix even more spellchecker warnings

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I6a4ea52c9ef02d4134e97729501a7e0371bfbbd4

Fix pre-commit and tox and gitlint settings

- create a .gitlint configuration to enforce subject line < 50 char
  and body lines < 72 char and a Signed-off-by field presence.
- (auto)update repository revisions in pre-commit configuration file
- fix pre-commit tox profile to make it work locally
- create a gitlint profile that works in CI
- create pre-commit-install and pre-commit-uninstall tox profiles to
  (un)install hooks locally and (un)perform tests at each "git commit"
  call (i.e. without calling manually the pre-commit tox profile)
- precise pre-commit stages/types in the pre-commit configuration file
  so that hooks are installed correctly. This avoids messages about
  skipped tests when they are run at a wrong stage.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I75b3b54b13e3d865ad6f563630bb0034456e7fe1

Fix more spellchecker warnings

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Ie11a9fe46ac3fb267a994062dd99d95a190c02a4

Fix some spellchecker warnings

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Icadc2a6aaaed2c8cc6312ec3d4ee331abfb0a0a3

Fix some dead links

update Karaf website Anchors in the security considerations section.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I2b0ae525b950229523043c9817f30e888e11030e

Decrease Sphinx tox profiles logs verbosity

This will ease gate failures analysis.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I0ae21afe7502383bf55113a23d99b23af13eb644

Fix some regex in docs/conf.py

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I847bcbb0744f7049097cdb840f0835cc9af46d9b

Update Si SR1 release schedule

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I9a1ce08b1293153a60d1e4dbb85df6487167d5df

remove netvirt from Phosphorus

Signed-off-by: Navid Ghazisaidi <navid.ghazisaidi@verizon.com>
Change-Id: Iad61e9b069f97aeb4ab498384008355a77b67b68

Update Download page

JIRA: DOCS-135
Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Id5ea71c727006ee850618fb99df7b2c5cbfbb1df
(cherry picked from commit 55bdfaf98976003268a70a0789bbbfa447eeeec5)

Merge "Adjust code after branching silicon"

Adjust code after branching silicon

Signed-off-by: Luis Gomez <ecelgp@gmail.com>
Change-Id: If0dbeab119cace3fd193183eb66b67e08fe7db8f