Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: refactor documentation #115

Merged
merged 21 commits into from
Jul 23, 2024
Merged
Show file tree
Hide file tree
Changes from 14 commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
8c697d0
docs: delete CODE_OF_CONDUCT.md
AnonymousWP Jun 22, 2024
3867816
docs: delete FUNDING.yml
AnonymousWP Jun 22, 2024
06a0ff0
docs: delete SECURITY.md
AnonymousWP Jun 22, 2024
ed43e57
docs: delete SPONSORS.md
AnonymousWP Jun 22, 2024
898bc4c
docs(contributors): move content to README
AnonymousWP Jun 22, 2024
8c008a4
build(ci): delete auto-comment.yml
AnonymousWP Jun 22, 2024
93760ba
Merge branch 'master' into refactor-documentation
AnonymousWP Jun 28, 2024
0f9cb00
docs(contributing): move file to root directory
AnonymousWP Jun 28, 2024
70a7d35
docs(release): create RELEASE.md
AnonymousWP Jun 28, 2024
0cd3863
docs(contributing): refactor contributing guide
AnonymousWP Jun 28, 2024
cd5da56
docs(readme): add 'Next Generation' to title
AnonymousWP Jun 28, 2024
756f7b6
docs(contributing): explain which branching strategy we use
AnonymousWP Jun 29, 2024
ba34e38
chore(namings): replace `reNgine` by `reNgine-ng`
AnonymousWP Jun 29, 2024
14ab16e
docs(readme): move scan engine to Wiki
AnonymousWP Jul 2, 2024
1ffa425
docs(readme): clarify this is a detached fork
AnonymousWP Jul 8, 2024
4e16071
docs(contributing): fix wrong project name
AnonymousWP Jul 8, 2024
23e1e22
project-name(documentation): use Wiki URL
AnonymousWP Jul 8, 2024
cd62f57
fix(updating): use correct update path
AnonymousWP Jul 8, 2024
6ab56c3
project-name(documentation): use lowercase for URL GitHub Issues
AnonymousWP Jul 8, 2024
a2635eb
docs: move README parts to CONTRIBUTING and Wiki
AnonymousWP Jul 8, 2024
7788fa7
fix(update): change API URI to lowercase
AnonymousWP Jul 23, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
74 changes: 0 additions & 74 deletions .github/CODE_OF_CONDUCT.md

This file was deleted.

60 changes: 0 additions & 60 deletions .github/CONTRIBUTING.md

This file was deleted.

3 changes: 0 additions & 3 deletions .github/FUNDING.yml

This file was deleted.

73 changes: 0 additions & 73 deletions .github/SECURITY.md

This file was deleted.

4 changes: 0 additions & 4 deletions .github/SPONSORS.md

This file was deleted.

37 changes: 0 additions & 37 deletions .github/workflows/auto-comment.yml

This file was deleted.

38 changes: 38 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Contributors Guide

## For who is this guide?

This guide is meant for users who want to contribute to the codebase of reNgine-ng, whether that is the application code or the JSON-file for adding packages. To keep all processes streamlined and consistent, we're asking you to stick to this guide whenever contributing.

Even though the guide is made for contributors, it's also strongly recommended that the UAD-ng team sticks to these guidelines. After all, we're a prime example.
AnonymousWP marked this conversation as resolved.
Show resolved Hide resolved

## What are the guidelines?

### Branching strategy

As for our branching strategy, we're using [Release Branching](https://www.split.io/blog/the-basics-of-release-branching/).

In short, a release branch is created from the main branch when the team is ready to roll out a new version. Only necessary changes like bug fixes and final touch-ups are made. Once finalized, it merges with the main branch for deployment. Urgent fixes after the release are handled using hotfix branches, which merge back into both the release and main branches. We do not use a `develop` branch as that adds complexity.

Some examples of branches are:

- Features (`feature/*`)
- Fixes (`hotfix/*` or simply `fix/*`)
- Dependency updates (`deps/*`)
- Releases (`release/*`)

Do mind that these branch names do only not apply when there's already an issue for the pull request. In that case we use the following scheme: `[issue number][issue title]`. This can be done [automatically](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-a-branch-for-an-issue) too.

This is how it looks like and works. The difference here is that we don't have a develop branch (so the purple dots that are connected with its mainline should not be included).

<img src="https://wac-cdn.atlassian.com/dam/jcr:cc0b526e-adb7-4d45-874e-9bcea9898b4a/04%20Hotfix%20branches.svg?cdnVersion=1871" alt="drawing" width="600"/>

So in short:

1. PR with feature/fix is opened
1. PR is merged into release branch
1. When we release a new version, release branch is merged to main

### Commit messages

As for commits, we prefer using [Conventional Commit Messages](https://gist.github.com/qoomon/5dfcdf8eec66a051ecd85625518cfd13). When working in any of the branches listed above (if there's an existing issue for it), close it using a [closing keyword](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword). For more information regarding Conventional Commit Messages, see <https://www.conventionalcommits.org/en/v1.0.0/> as well.
22 changes: 0 additions & 22 deletions CONTRIBUTORS.md

This file was deleted.

4 changes: 2 additions & 2 deletions LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -631,7 +631,7 @@ to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.

reNgine - automated reconnaissance framework
reNgine-ng - automated reconnaissance framework
Copyright (C) 2024 Yogesh Ojha

This program is free software: you can redistribute it and/or modify
Expand All @@ -652,7 +652,7 @@ Also add information on how to contact you by electronic and paper mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:

reNgine Copyright (C) 2024 Yogesh Ojha
reNgine-ng Copyright (C) 2024 Yogesh Ojha
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
Expand Down
Loading
Loading