documentation fixes

Author: grisumbras

CHANGELOG.adoc

@@ -7,6 +7,9 @@ include::doc/pages/definitions.adoc[]
 
 == Boost 1.89.0
 
+.Documentation
+* New documentation style. New reference documentation structure.
+
 .API Changes
 * {issue}1050[#1050] Optionals that are ranges are categorised as optionals.
 * {issue}1086[#1086] Described class support is enabled for types with bases.

README.adoc

@@ -8,7 +8,7 @@ ifdef::env-github[]
 :source-highlighter: rouge
 :source-language: c++
 
-[link=https://www.boost.org/doc/libs/release/libs/json]
+[link=https://www.boost.org/doc/libs/latest/libs/json]
 image:https://raw.githubusercontent.com/CPPAlliance/json/master/doc/images/repo-logo-3.png[Boost.JSON]
 
 [cols=3]
@@ -127,11 +127,11 @@ endif::[]
 
 * Requires only {cpp}11
 * Link to a built static or dynamic Boost library (build instructions can be
-  found https://www.boost.org/doc/libs/release/more/getting_started/index.html[here]),
+  found https://www.boost.org/doc/libs/latest/more/getting_started/index.html[here]),
   or use header-only (see below)
 * Additional link to Boost.Container may be required
   (as described in its
-  https://www.boost.org/doc/libs/release/doc/html/container.html#container.intro.introduction_building_container[documentation])
+  https://www.boost.org/doc/libs/latest/doc/html/container.html#container.intro.introduction_building_container[documentation])
 * Supports `-fno-exceptions`, detected automatically (but read
   <<Disabling Exceptions,the relevant section>> on this page).
 
@@ -161,7 +161,7 @@ completely you can define `BOOST_ALL_NO_LIB` instead.
 ==== Disabling Exceptions
 In order to support building with exceptions disabled this library uses another
 Boost library,
-https://www.boost.org/doc/libs/release/libs/throw_exception[Boost.ThrowException].
+https://www.boost.org/doc/libs/latest/libs/throw_exception[Boost.ThrowException].
 This allows to automatically discover whether exception support is available.
 On the other hand, as explained in Boost.ThrowException's documentation, if
 exceptions are disabled, the users need to provide their own implementation for
@@ -193,7 +193,7 @@ definitions:
 
 ==== Endianness
 Boost.JSON uses
-https://www.boost.org/doc/libs/release/libs/endian/doc/html/endian.html[Boost.Endian]
+https://www.boost.org/doc/libs/latest/libs/endian/doc/html/endian.html[Boost.Endian]
 in order to support both little endian and big endian platforms.
 
 ==== Supported Compilers

doc/pages/definitions.adoc

@@ -7,13 +7,13 @@ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
 Official repository: https://github.com/boostorg/json
 ////
 
-:ref_memory_resource:       pass:q[https://boost.org/doc/libs/release/doc/html/doxygen/boost_container_header_reference/classboost_1_1container_1_1pmr_1_1memory__resource.html[`memory_resource`]]
-:ref_polymorphic_allocator: pass:q[https://boost.org/doc/libs/release/doc/html/doxygen/boost_container_header_reference/classboost_1_1container_1_1pmr_1_1polymorphic__allocator.html[`polymorphic_allocator`]]
-:ref_error_category:        pass:q[https://boost.org/doc/libs/release/libs/system/doc/html/system.html#ref_error_category[`error_category`]]
-:ref_error_code:            pass:q[https://boost.org/doc/libs/release/libs/system/doc/html/system.html#ref_error_code[`error_code`]]
-:ref_error_condition:       pass:q[https://boost.org/doc/libs/release/libs/system/doc/html/system.html#ref_error_condition[`error_condition`]]
-:ref_result:                pass:q[https://boost.org/doc/libs/release/libs/system/doc/html/system.html#ref_resultt_e[`result`]]
-:ref_system_error:          pass:q[https://boost.org/doc/libs/release/libs/system/doc/html/system.html#ref_system_error[`system_error`]]
+:ref_memory_resource:       pass:q[https://boost.org/doc/libs/latest/doc/html/doxygen/boost_container_header_reference/classboost_1_1container_1_1pmr_1_1memory__resource.html[`memory_resource`]]
+:ref_polymorphic_allocator: pass:q[https://boost.org/doc/libs/latest/doc/html/doxygen/boost_container_header_reference/classboost_1_1container_1_1pmr_1_1polymorphic__allocator.html[`polymorphic_allocator`]]
+:ref_error_category:        pass:q[https://boost.org/doc/libs/latest/libs/system/doc/html/system.html#ref_error_category[`error_category`]]
+:ref_error_code:            pass:q[https://boost.org/doc/libs/latest/libs/system/doc/html/system.html#ref_error_code[`error_code`]]
+:ref_error_condition:       pass:q[https://boost.org/doc/libs/latest/libs/system/doc/html/system.html#ref_error_condition[`error_condition`]]
+:ref_result:                pass:q[https://boost.org/doc/libs/latest/libs/system/doc/html/system.html#ref_resultt_e[`result`]]
+:ref_system_error:          pass:q[https://boost.org/doc/libs/latest/libs/system/doc/html/system.html#ref_system_error[`system_error`]]
 
 :req_Allocator:            pass:q[https://en.cppreference.com/w/cpp/named_req/Allocator[__Allocator__]]
 :req_CopyAssignable:       pass:q[https://en.cppreference.com/w/cpp/named_req/CopyAssignable[__CopyAssignable__]]

doc/pages/dom/value.adoc

@@ -78,7 +78,7 @@ include::../../../test/snippets.cpp[tag=snippet_value_4,indent=0]
 ----
 
 The following table shows all of the ways to determine and access the contents
-of a `!value!`:
+of a <<ref_value>>:
 
 .<<ref_value>> Accessors
 [%autowidth,cols=8]

include/boost/json/conversion.hpp

@@ -322,7 +322,7 @@ struct is_null_like
     non-public data members to enable this conversion implementation. Note that
     non-public bases are not supported regardless.
 
-    @see [Boost.Describe](https://www.boost.org/doc/libs/develop/libs/describe/doc/html/describe.html).
+    @see [Boost.Describe](https://www.boost.org/doc/libs/latest/libs/describe/doc/html/describe.html).
 */
 template<class T>
 struct is_described_class;
@@ -353,7 +353,7 @@ struct is_described_class;
     } // namespace json
     @endcode
 
-    @see [Boost.Describe](https://www.boost.org/doc/libs/develop/libs/describe/doc/html/describe.html).
+    @see [Boost.Describe](https://www.boost.org/doc/libs/latest/libs/describe/doc/html/describe.html).
 */
 template<class T>
 struct is_described_enum;