Add full DFG Fachsystematik 2016 to docs

src/coscine/client.py

@@ -815,12 +815,58 @@ class ApiClient:
     def discipline(self, name: str) -> Discipline:
         """
         Returns the discipline that matches the name.
-        Valid names would be for example:
+        Valid names are:
+        * "Ancient Cultures 101"
+        * "History 102"
+        * "Fine Arts, Music, Theatre and Media Studies (103)"
+        * "Linguistics 104"
+        * "Library Studies 105"
+        * "Social and Cultural Anthropology, Non-European Cultures, Jewish Studies and Religious Studies 106"
+        * "Theology 107"
+        * "Philosophy 108"
+        * "Educational Research 109"
+        * "Psychology 110"
+        * "Social Sciences 111"
+        * "Economics 112"
         * "Jurisprudence 113"
-        * "Materials Science 406"
+        * "Basic Biological and Medical Research 201"
+        * "Plant Sciences 202"
+        * "Zoology 203"
+        * "Microbiology, Virology and Immunology 204"
         * "Medicine 205"
+        * "Neurosciences 206"
+        * "Agriculture, Forestry and Veterinary Medicine 207"
+        * "Molecular Chemistry 301"
+        * "Chemical Solid State and Surface Research 302"
+        * "Physical and Theoretical Chemistry 303"
+        * "Analytical Chemistry, Method Development (Chemistry) 304"
+        * "Biological Chemistry and Food Chemistry 305"
+        * "Polymer Research 306"
+        * "Condensed Matter Physics 307"
+        * "Optics, Quantum Optics and Physics of Atoms, Molecules and Plasmas 308"
+        * "Particles, Nuclei and Fields 309"
+        * "Statistical Physics, Soft Matter, Biological Physics, Nonlinear Dynamics 310"
+        * "Astrophysics and Astronomy 311"
+        * "Mathematics 312"
+        * "Atmospheric Science, Oceanography and Climate Research 313"
+        * "Geology and Palaeontology 314"
+        * "Geophysics and Geodesy 315"
+        * "Geochemistry, Mineralogy and Crystallography 316"
+        * "Geography 317"
+        * "Water Research 318"
+        * "Production Technology 401"
+        * "Mechanics and Constructive Mechanical Engineering 402"
+        * "Process Engineering, Technical Chemistry 403"
+        * "Heat Energy Technology, Thermal Machines, Fluid Mechanics 404"
+        * "Materials Engineering 405"
+        * "Materials Science 406"
+        * "Systems Engineering 407"
+        * "Electrical Engineering and Information Technology 408"
         * "Computer Science 409"
-        * ...
+        * "Construction Engineering and Architecture 410"
+        I had to copy these manually from a DFG PDF!
+        The absolute state of digitization in germany...
+        Expect some typos!
         """
         results = list(filter(
             lambda discipline: discipline.name == name,
@@ -917,7 +963,7 @@ class ApiClient:
 
     def languages(self) -> list[Language]:
         """
-        Retrieves all languages available in Coscine.
+        Retrieves all language options available in Coscine.
         """
         uri = self.uri("languages")
         return [
@@ -929,6 +975,17 @@ class ApiClient:
     def organization(self, ror_uri: str) -> Organization:
         """
         Looks up an organization based on its ror uri.
+        Some commonly used ROR uris:
+        "https://ror.org/04xfq0f34" -> RWTH Aachen
+        "https://ror.org/04tqgg260" -> FH Aachen
+        "https://ror.org/04t3en479" -> KIT
+        "https://ror.org/02kkvpp62" -> TUM
+        "https://ror.org/05n911h24" -> TU Darm
+        "https://ror.org/01k97gp34" -> TU Do
+        "https://ror.org/02gm5zw39" -> UKA
+        "https://ror.org/00rcxh774" -> Uni Köln
+        "https://ror.org/04mz5ra38" -> Uni Due
+        "https://ror.org/00pd74e08" -> Uni Mün
         """
         uri = self.uri("organizations", ror_uri)
         return Organization(self.get(uri).data)