You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

To initiate the project, please submit a project creation request to the administrator via the provided form. Upon approval, the administrator will grant access to a Git repository hosted on GitHub. Authorized users will then have the capability to create branches within this repository, facilitating collaborative development and version control.

Remember: the 'main' branch cannot be modified directly, each developer need to use branches and create a github Pull Request(PR) to merge desidere branches into main

Project Overview

The cloned repository will have a structure like this:

react-ui-base-project-folder-content


  • .gitignore is a file that tells Git which files and folders to ignore. You typically wouldn't document this file.
  • Dockerfile is a file that contains instructions for how to build a Docker image. You can include instructions on how to build and run the Docker image in your documentation, this file is principally used by the predefined github workflow that use it to build the docker image that will be deployed on EED kubernetes cluster.
  • package-lock.json is a file that contains information about the exact versions of dependencies that are installed in your project. You typically wouldn't document this file.
  • package.json is a file that contains information about your project, such as its name, version, and dependencies. You can include information from your package.json file in your documentation, such as how to install the dependencies and how to run the project.
  • src

    • This folder likely contains the source code for your React components and application logic.

      • You'll want to document the components, including their props, state, and methods. It may also be helpful to create usage examples in your documentation.
    • src often also contains subfolders, each corresponding to a part of your UI (e.g.,componentsorpages`). Document each subfolder's contents.


  • public

    • This folder typically contains static assets that are served by your web server, such as your index.html file, favicon, and any CSS or JavaScript files that aren't part of your React components.
      • Your index.html file may also reference your CSS and JavaScript files.
      • Document how all those files are used.
    • You'll want to list the contents of the public folder in your documentation and explain how they are used.

    logos

    • This folder may contain logos that you use in your React UI demo.
      • If so, list the contents of the logos folder and what each logo is used for.

    content and .github/workflows: These folders are not typical of a basic React UI demo folder, so their purpose and contents will depend on your specific project. Document them accordingly.


  • No labels