Skip to content

tegonal-bot/oss-template

 
 

Repository files navigation

Following the steps you should perform after cloning this template repository:

  1. execute init.sh

  2. adjust/check the TBD in this file

  3. add a new discussion category Contributor Q&A -- Ask other contributors for help

  4. in order that the tegonal-bot pushes changes to its own fork (e.g. when executing gt-update.yml -- see below for an explanation) and then create a normal PR you need to:

    1. add the repository variable AUTO_PR_FORK_NAME with value tegonal-bot/PROJECT_NAME_GITHUB
    2. login as tegonal-bot and then fork the repository
  5. Following a short introduction in the scripts already setup in this repository:

    1. before-pr.sh is executed in .github/workflows/quality_assurance.yml and runs cleanup-on-push-to-main.sh and run-shellcheck.sh
    2. cleanup-on-push-to-main.sh is executed in .github/workflows/cleanup.yml meant to cleanup after a PR. => put commands such as code formatting in it
    3. run-shellcheck.sh checks that shellcheck doesn't find issues in script located in /scripts
  6. Following a short introduction in the workflows already setup in this repository:

    1. cleanup.yml => run after push on main and intended to cleanup after a PR.
    2. gt-update.yml => run periodically, updates all files pulled in via gt
    3. quality-assurance.yml => run for PR and pushed, checks that the code/script quality and such are ok. => you will typically add more jobs which run tests (sbt test or gradle build)
  7. git commit -a -m "initialised"

  8. As last step, delete this section and you are ready to start with your new OSS project

Download LICENSE_BADGE Quality Assurance Newcomers Welcome

PROJECT_NAME

TBD


❗ You are taking a sneak peek at the next version. It could be that some features you find on this page are not released yet.
Please have a look at the README of the corresponding release/git tag. Latest version: README of v0.1.0.


Table of Content

Installation

TBD PROJECT_NAME is published to maven central.

Documentation

TBD Code documentation can be found on github-pages: https://tegonal.github.io/PROJECT_NAME.

Contributors and contribute

Our thanks go to code contributors as well as all other contributors (e.g. bug reporters, feature request creators etc.)

You are more than welcome to contribute as well:

Please have a look at CONTRIBUTING.md for further suggestions and guidelines.

License

PROJECT_NAME is licensed under LICENSE_LINK

About

Template for a new OSS project

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%