Project:Documentation Overview: Difference between revisions

← Older edit

VisualWikitext

Latest revision as of 12:25, 7 February 2025

Overview of the current public documentation and meeting notes.

Onboarding

This contains guidelines for recurring tasks within the project.

Mediawiki documentation

Wikibase documentation

Useful external documentaton for Wikibase.

MaRDI Portal frontend

Docker development

Development with docker in OpenStack: How to set up an OpenStack instance with docker for development.
Access a docker container: How to access a docker container through SSH or portainer.
Deployment: Description of deployment procedure for staging and production.
Bypass branch protection: How to bypass branch protection in portal-compose.
Creating a pull request: Conventions for creating a PR.
Backup volumes: How to backup docker volumes.

Kubernetes

MaRDI Kubernetes cluster: Documentation on setting up and managing services in the K8s cluster.

Jobrunner

Check jobqueue: How to list the current number of jobs.

Importer

Isolated scripts: Documentation importer scripts for isolated tasks.
Import Wikidata entities: How to import a Wikidata entity to the portal.
Class definitions: Class definitions used in the importer python package.
Generate docs with sphinx: Documentation on generating the importer documentation with sphinx.
OpenML data model

DB

Project:MySQL

ElasticSearch/CirrusSearch

Project:DebuggingIndexing

SPARQL

WDQS configuration: General notes on our specific WDQS (Blazegraph) configuration.
Run WDQS updater: Notes on resynchronizing Blazegraph with the Wikibase SQL state.
Run large SPARQL queries: How to run SPARQL queries that time out in the query service.

@@ Line 1: / Line 1: @@
 Overview of the current public documentation and meeting notes.
-'''Standard Operating Procedures:'''
+==== '''Onboarding''' ====
+This contains guidelines for recurring tasks within the project.
-This contains guidelines for recurring tasks within the project.
+* [[Project:Onboarding|Onboarding]] of new persons in Team
+* [[Project:Getting Started|Getting Started]]
+* [[Technical introduction]]
+* [[Answers to specific technical questions]]
+* [[Suggestions and Discussion on Future MaRDI Steps]]
+* [[Project:New queries about the portal 2024]]
+* [[Project:Documentation of KPI 2024]]
-* [[Project:Emergency Guide for Bypassing Branch Protection Rules]]
+==== '''Mediawiki documentation''' ====
+* [https://www.mediawiki.org/wiki/Manual:Configuration_settings#Uploads| List of $wg Parameters]
+* [[Private:How to change passwords]]
+* [[Project:Develop_and_Test_Mediawiki_Code_on_Production]]
-'''Technical Documentation:'''
+==== '''Wikibase documentation''' ====
+Useful external documentaton for Wikibase.
+* [[mediawikiwiki:Wikibase/FAQ|Wikibase FAQ]]
+* [[mediawikiwiki:Wikibase/Installation/Advanced_configuration|Advanced Wikibase documentation]]
+* [[d:Help:Property_constraints_portal|Wikibase property constraints portal]]
+* [[Project:ItemDeletion]]
-*[[Project:Backups]]
+==== '''MaRDI Portal frontend''' ====
+* [[MaRDI_Services|MaRDI Services]]
+* [[Project:Design Information|Design Information]]
+* [[Project:Personas]]
+* [[Project:Showcases]]
+* [[Project:Profile types|Profile types]]
+* [[Project:Profile_types/CommunityProfile|Community profiles]]
+* [[Project:KPI|Knowledge Graph Statistics]]
+* [[Project:Services]]
+* [[Project:LLMQueryService_POC]]
+==== '''Docker development''' ====
+;[[Project:Docker_OpenStackVM|Development with docker in OpenStack]]
+:How to set up an OpenStack instance with docker for development.
+;[[Project:Access Docker container|Access a docker container]]
+:How to access a docker container through SSH or portainer.
+;[[Project:Deployment|Deployment]]
+:Description of deployment procedure for staging and production.
+;[[Project:Emergency Guide for Bypassing Branch Protection Rules|Bypass branch protection]]
+:How to bypass branch protection in [https://github.com/MaRDI4NFDI/portal-compose portal-compose].
+;[[Project:Process for Pull Requests|Creating a pull request]]
+:Conventions for creating a PR.
+;[[Project:Backups|Backup volumes]]
+:How to backup docker volumes.
+==== '''Kubernetes''' ====
+;[[Project:Kubernetes| MaRDI Kubernetes cluster]]
+:Documentation on setting up and managing services in the K8s cluster.
+==== '''Jobrunner''' ====
+;[[Project:Jobqueue|Check jobqueue]]
+:How to list the current number of jobs.
+==== '''Importer''' ====
+;[[Project:Scripts|Isolated scripts]]
+:Documentation importer scripts for isolated tasks.
+;[[Project:Import Wikidata Entities|Import Wikidata entities]]
+:How to import a Wikidata entity to the portal.
+;[[Project:ImporterDocumentation|Class definitions]]
+:Class definitions used in [https://github.com/mardi4nfdi/docker-importer the importer python package].
+;[[Project:Auto-documenting python with sphinx|Generate docs with sphinx]]
+:Documentation on generating the [https://mardi4nfdi.github.io/docker-importer/ importer documentation] with sphinx.
+;[[Project:OpenMLDatamodels|OpenML data model]]
+==== '''DB''' ====
+* [[Project:MySQL]]
+==== '''ElasticSearch/CirrusSearch''' ====
+* [[Project:DebuggingIndexing]]
+==== '''SPARQL''' ====
+;[[Project:WDQS_configuration| WDQS configuration]]
+:General notes on our specific WDQS (Blazegraph) configuration.
+;[[Project:RerunUpdate| Run WDQS updater]]
+:Notes on resynchronizing Blazegraph with the Wikibase SQL state.
+;[[Project:LargeSPARQL| Run large SPARQL queries]]
+:How to run SPARQL queries that time out in the [https://query.portal.mardi4nfdi.de query service].
+==== '''PHP development''' ====
+* [[Project:DebuggingPHPinMediawiki]]
 * [[Project:Testing concept]]
+* [[Project:Develop and Test Mediawiki Code on Production]]
-'''Requirements Gathering:'''
+==== '''MathSearch''' ====
+* [[Project:Deployment of Math Search|'''Deployment of MathSearch''']]
+==== '''Quickstatements''' ====
+* [[Project:QuickStatements]]
+==== '''Requirements Gathering''' ====
 * [[Project:Requirements]]
 * [[Project:Questionnaire Task Areas]]
-'''Internal Meeting Notes:'''
+==== '''Internal Meeting Notes''' ====
 * [[Project:Weekly-20220115]]
 * [[Project:Weekly-20220121]]
@@ Line 24: / Line 104: @@
 * [[Project:Weekly-20220211|Weekly-20220211]]
 * [[Project:Weekly-20220218|Weekly-20220218]]
-*
+* [[Project:Weekly-20220225|Weekly-20220225]]
+* [[Project:Weekly-20220304|Weekly-20220304]]
+* [[Project:Weekly-20220311|Weekly-20220311]]
+* [[Project:Weekly-20220318]]
+* [[Project:Weekly-20220325]]
+* [[Project:Weekly-20220530]]
+* [[Project:Weekly-20220613]]
+* [[Project:Weekly-20220620]]
+* [[Project:Weekly-20220627]]
+* [[Project:Weekly-20220711]]
+* [[Project:Weekly-20220718]]
+* [[Project:Weekly-20220725]]
+* [[Project:Weekly-20220815]]
+* [[Project:Weekly-20220822]]
+* [[Project:Weekly-20220829]]
+* [[Project:Weekly-20220905]]
+* [[Project:MilestonesMeeting/20240223]]
+* [[Project:MilestonesMeeting/20240923]]
-'''Task Area Meeting Notes:'''
+==== '''Task Area Meeting Notes''' ====
 * [[Project:Treffen-T1-20220114]]
 * [[Project:Treffen-T3-20220120]]
 * [[Project:Treffen-T2-20220127]]
+* [[:Category:Task_Area_Meeting_Notes|More]]
-'''Private documentation overview:'''
+==== '''Private documentation overview''' ====
 * [[Private:Documentation_Overview]]