Skip to content

Move documentation to right folders and add user manual#97

Open
RolandJentschETAS wants to merge 1 commit into
mainfrom
improvement_move_documentation_folders
Open

Move documentation to right folders and add user manual#97
RolandJentschETAS wants to merge 1 commit into
mainfrom
improvement_move_documentation_folders

Conversation

@RolandJentschETAS

Copy link
Copy Markdown
Contributor

This pull request introduces several improvements and additions to the documentation structure and templates for the project. The main focus is on enhancing the modularity and clarity of the documentation, providing comprehensive templates for user and component manuals, and reorganizing the documentation layout for better usability.

Summary of Most Important Changes:

1. Documentation Structure and Template Enhancements

  • Added a comprehensive user manual template (user_manuel.rst) covering installation, configuration, usage, integration, troubleshooting, safety, security, and contribution guidelines. This template is now referenced in the manuals table of contents. [1] [2]
  • Introduced a detailed component architecture documentation template (component_architecture.rst) for use in component-level documentation, including sections for requirements, static and dynamic architecture, interfaces, and internal components.

2. Improvements to Documentation Organization

  • Updated the main documentation index (index.rst) to:
    • Clarify and expand the directory structure for manuals, highlighting optional user-centric documentation such as configuration guides, examples, API descriptions, and performance analysis. [1] [2]
    • Replace the previous quick start, configuration, and component documentation sections with a more concise and modular template, delegating detailed documentation to the respective new templates.
    • Correct the reference to the component architecture template to point to the new file.

3. Cleanup and Streamlining

  • Removed the outdated "Module Viewpoint" section from the feature architecture documentation, focusing the section on used components and streamlining the logical interfaces documentation.

These changes collectively improve the maintainability, clarity, and extensibility of the project's documentation, making it easier for new users and contributors to get started and for teams to document features and components in a consistent manner.

@github-actions

Copy link
Copy Markdown

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run --lockfile_mode=error //:license-check

Status: ⚠️ Needs Review

Click to expand output
[License Check Output]
Extracting Bazel installation...
Starting local Bazel server (8.6.0) and connecting to it...
INFO: Invocation ID: 0a35ad9c-2f0f-4dff-9255-51647f93ec05
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
WARNING: For repository 'score_process', the root module requires module version score_process@1.5.4, but got score_process@1.6.0 in the resolved dependency graph. Please update the version in your MODULE.bazel or set --check_direct_dependencies=off
Loading: 
Loading: 0 packages loaded
Loading: 0 packages loaded
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)

Analyzing: target //:license-check (34 packages loaded, 10 targets configured)

Analyzing: target //:license-check (78 packages loaded, 10 targets configured)

Analyzing: target //:license-check (83 packages loaded, 10 targets configured)

Analyzing: target //:license-check (99 packages loaded, 38 targets configured)

Analyzing: target //:license-check (153 packages loaded, 2959 targets configured)

Analyzing: target //:license-check (160 packages loaded, 5468 targets configured)

Analyzing: target //:license-check (160 packages loaded, 5468 targets configured)

Analyzing: target //:license-check (160 packages loaded, 5468 targets configured)

Analyzing: target //:license-check (160 packages loaded, 5468 targets configured)

Analyzing: target //:license-check (163 packages loaded, 7353 targets configured)

Analyzing: target //:license-check (166 packages loaded, 10025 targets configured)

Analyzing: target //:license-check (167 packages loaded, 10160 targets configured)

Analyzing: target //:license-check (167 packages loaded, 10160 targets configured)

Analyzing: target //:license-check (167 packages loaded, 10160 targets configured)

Analyzing: target //:license-check (167 packages loaded, 10160 targets configured)

Analyzing: target //:license-check (168 packages loaded, 10280 targets configured)

Analyzing: target //:license-check (168 packages loaded, 10280 targets configured)

INFO: Analyzed target //:license-check (169 packages loaded, 11859 targets configured).
[12 / 16] [Prepa] JavaToolchainCompileClasses external/rules_java+/toolchains/platformclasspath_classes
INFO: From Generating Dash formatted dependency file ...:
INFO: Successfully converted 2 packages from Cargo.lock to bazel-out/k8-fastbuild/bin/formatted.txt
[14 / 16] JavaToolchainCompileBootClasspath external/rules_java+/toolchains/platformclasspath.jar; 0s disk-cache, processwrapper-sandbox
[15 / 16] Building license.check.license_check.jar (); 0s disk-cache, multiplex-worker
INFO: Found 1 target...
Target //:license.check.license_check up-to-date:
  bazel-bin/license.check.license_check
  bazel-bin/license.check.license_check.jar
INFO: Elapsed time: 204.979s, Critical Path: 2.54s
INFO: 16 processes: 12 internal, 3 processwrapper-sandbox, 1 worker.
INFO: Build completed successfully, 16 total actions
INFO: Running command line: bazel-bin/license.check.license_check ./formatted.txt <args omitted>
usage: org.eclipse.dash.licenses.cli.Main [-batch <int>] [-cd <url>]
       [-confidence <int>] [-ef <url>] [-excludeSources <sources>] [-help] [-lic
       <url>] [-project <shortname>] [-repo <url>] [-review] [-summary <file>]
       [-timeout <seconds>] [-token <token>]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant