Migrate more documentation to the official Sphinx docs and mention IfcOpenShell-WASM as an installation option

src/ifcopenshell-python/docs/bimserver-plugin.rst

@@ -1,16 +1,5 @@
 BIMServer-Plugin
 ================
 
-This documentation is free software! You are free to contribute and help write
-this document.
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Contents:
-
-Indices and tables
-------------------
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+The BIMServer-Plugin is a plugin to the open source BIMServer CDE to allow you
+to use IfcOpenShell to parse, view, and audit models.

src/ifcopenshell-python/docs/bimtester.rst

@@ -1,16 +1,4 @@
 BIMTester
 =========
 
-This documentation is free software! You are free to contribute and help write
-this document.
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Contents:
-
-Indices and tables
-------------------
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+BIMTester is a utility that allows you to write Gherkin-based tests for models.

src/ifcopenshell-python/docs/bsdd.rst

@@ -0,0 +1,56 @@
+bSDD
+====
+
+The **buildingSMART Data Dictionary** (bSDD) is an online RESTful centralised
+API provided by buildingSMART that allows you to search for standardised
+classifications and properties.
+
+For example, if you want to assign a Uniclass classification system (popular in
+the UK) or an Omniclass classification system (popular in the US) to elements
+in your model, instead of downloading the classification system from their
+website, you can directly search the bSDD. This ensures that you are always up
+to date, and that codes are entered correctly (without spelling mistakes,
+correct formatting, etc).
+
+The bSDD search results may also be filtered based on IFC class. This will make
+it quick to shortlist relevant classification codes and properties to a
+particular object.
+
+The bSDD also stores information on whether or not classification systems
+require additional standard properties to be filled out, and whether they
+should be filled out in a particular way. For example, all countries need to
+fill out a "Fire Rating" property for walls, but they have different ways to
+fill it out. Local governments (or companies) may submit their standard to the
+bSDD so that all bSDD-compatible BIM applications can look up the property and
+fill it out in a standardised way (such as picking for a list of preset
+possible values defined by the local government).
+
+More reading:
+
+1. `Swagger API docs <https://bs-dd-api-prototype.azurewebsites.net/swagger/index.html>`_
+2. `bSDD Github Repository <https://github.com/buildingSMART/bSDD>`_
+
+Examples
+--------
+
+Learning how to use the bSDD is best done by reading the official Swagger API docs.
+
+.. code-block:: python
+
+    client = Client()
+
+    # Get a list of "dictionary domains". For example, Uniclass (by the NBS organisation) might be one domain.
+    print(client.Domain())
+
+    # For example, search the Netherland's Nlsfb2005 classification standard for all codes that apply to an IfcWall.
+    print(client.SearchListOpen("http://identifier.buildingsmart.org/uri/nlsfb/nlsfb2005-2.2", RelatedIfcEntity="IfcWall"))
+
+    # Alternatively, search up a particular classification code.
+    data = client.Classification("http://identifier.buildingsmart.org/uri/nlsfb/nlsfb2005-2.2/class/21.21")
+    print(data)
+
+    # You may also apply default properties (if the classification system on
+    # the bSDD defines them) to your IFC element. For example, if a
+    # classification code is for a load bearing wall, it can automatically set
+    # the "LoadBearing" property to True for you.
+    apply_ifc_classification_properties(ifc_file, element, data["classificationProperties"])

src/ifcopenshell-python/docs/conf.py

@@ -67,6 +67,7 @@ autoapi_type = 'python'
 
 # autoapi works by reading source code instead of importing modules
 autoapi_dirs = ['../ifcopenshell', '../../ifcdiff', '../../ifcpatch/ifcpatch']
+autoapi_dirs = ['../../ifcdiff', '../../ifcpatch/ifcpatch']
 
 # These are auto-generated based on the IFC schema, so exclude them
 autoapi_ignore = ['*ifcopenshell/express/rules*']

src/ifcopenshell-python/docs/ifccobie.rst

@@ -1,16 +0,0 @@
-IfcCOBie
-========
-
-This documentation is free software! You are free to contribute and help write
-this document.
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Contents:
-
-Indices and tables
-------------------
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`

src/ifcopenshell-python/docs/ifcfm.rst

@@ -0,0 +1,4 @@
+IfcFM
+=====
+
+IfcFM is a utility to

src/ifcopenshell-python/docs/ifcmax.rst

@@ -0,0 +1,20 @@
+IfcMax
+======
+
+IfcMax is a 3ds Max importer plugin able to import the IFC file format.
+
+Community builds are available for 3ds Max by Josef Wienerroither (also known
+as ``FrogsInSpace`` or ``spacefrog``). Builds are available for IfcOpenShell
+v0.7.0 for 3ds Max version 2020-2024. Older builds are also available for
+IfcOpenShell v0.6.0 for 3ds Max version 2015-2022.
+
+It is recommended to use the latest version of IfcOpenShell and 3ds Max.
+
+- `Visit FrogsInSpace official website for IfcMax <https://www.frogsinspace.at/?p=3454>`__.
+- `Download IfcMax plugins <https://github.com/FrogsInSpace/IfcOpenShell/releases>`__.
+
+.. note::
+
+    This plugin is purely an importer and does not handle native IFC authoring
+    or exporting. For more information for native IFC authoring, we recommend
+    using the :doc:`BlenderBIM Add-on<blenderbim>`.

src/ifcopenshell-python/docs/ifcopenshell-python/installation.rst

@@ -11,9 +11,10 @@ packages**. If you aren't a programmer, go for the **BlenderBIM Add-on**.
 4. **Docker** is recommended for developers using Docker.
 5. **AWS Lambda** is recommended for developers using AWS Lambda functions.
 6. **Google Colab** is recommended for developers using Google Colab.
-7. **Using the BlenderBIM Add-on** is recommended for non-developers wanting a graphical interface.
-8. **From source with precompiled binaries** is recommended for developers actively working with the Python code.
-9. **Compiling from source** is recommended for developers actively working with the C++ core.
+7. **Web Assembly** is recommended for developers experimenting with IfcOpenShell on the web.
+8. **Using the BlenderBIM Add-on** is recommended for non-developers wanting a graphical interface.
+9. **From source with precompiled binaries** is recommended for developers actively working with the Python code.
+10. **Compiling from source** is recommended for developers actively working with the C++ core.
 
 Pre-built packages
 ------------------
@@ -197,6 +198,17 @@ local system.
 <https://colab.research.google.com/drive/1S9uZQvqXRpF1z6JTiKk79M1Ln63rHHIZ?usp=sharing>`__
 to launch a simple notebook.
 
+Web Assembly
+------------
+
+IfcOpenShell is available as technology preview to be run using WASM. This
+allows you to run IfcOpenShell in a browser using pyodide. This implementation
+is incredibly heavy and will incur a long load time, but once loaded, will give
+you full access to the entire IfcOpenShell API.
+
+`Click here <https://github.com/IfcOpenShell/wasm-preview>`__ to learn how to
+use WASM.
+
 Using the BlenderBIM Add-on
 ---------------------------
 

src/ifcopenshell-python/docs/index.rst

@@ -22,16 +22,19 @@ IfcOpenShell is a suite of developer libraries and utilities to manipulate OpenB
    :maxdepth: 1
    :caption: Utilities:
 
+   bcf
    bimserver-plugin
    bimtester
+   bsdd
    ifc2ca
    ifc4d
    ifc5d
    ifccityjson
    ifcclash
-   ifccobie
    ifccsv
    ifcdiff
+   ifcfm
+   ifcmax
    ifcpatch
    ifcsverchok
    ifctester