Diff of /docs/wiki-Home.md [000000] .. [8c4ad8]

Switch to unified view

a b/docs/wiki-Home.md
1
# Welcome to the DNAnalyzer Wiki!
2
3
![](https://user-images.githubusercontent.com/96280466/186224441-46dd2029-b9dc-4b3d-aad8-bfd1e1e62f2e.png)
4
5
> DNAnalyzer identifies proteins, amino acids, start and stop codons, high coverage regions, and regulatory elements.
6
> Researchers are working to extract valuable information to better understand human health and disease.
7
> Currently, we are developing a Command-Line Interface (CLI) and a Graphical User Interface (GUI) to enable physicians
8
> to quickly identify genetic mutations.
9
10
## Documents
11
[View Documents](https://github.com/VerisimilitudeX/DNAnalyzer/tree/main/docs)
12
13
## Contributing
14
15
### Steps to follow 📜
16
17
1. **Fork it 🍴**  
18
   Get your own fork of [DNAnalyzer](https://github.com/VerisimilitudeX/DNAnalyzer) by using the `Fork` button at the top right of this page.  
19
   ![](https://github-images.s3.amazonaws.com/help/bootcamp/Bootcamp-Fork.png)
20
21
2. **Clone it 👥**  
22
   Clone your fork to your local machine:
23
   ```bash
24
   git clone https://github.com/Your_Username/DNAnalyzer.git
25
   cd DNAnalyzer
26
   ```
27
   Then, add a reference to the original repository:
28
   ```bash
29
   git remote add upstream https://github.com/theabhishek07/DNAnalyzer.git
30
   git remote -v
31
   ```
32
33
3. **Sync with the Remote 🔄**  
34
   Keep your local repository up-to-date:
35
   ```bash
36
   git fetch --all --prune
37
   git checkout main
38
   git reset --hard upstream/main
39
   git push origin main
40
   ```
41
42
4. **Create a new branch**  
43
   Create a new branch for your contribution:
44
   ```bash
45
   git checkout -b <branchname>
46
   ```
47
   To switch branches later:
48
   ```bash
49
   git checkout <branchname>
50
   ```
51
   Add changes and commit:
52
   ```bash
53
   git add .
54
   git commit -m "your commit message"
55
   ```
56
   Push your branch:
57
   ```bash
58
   git push -u origin <branchname>
59
   ```
60
   Finally, in your browser, navigate to your repository, click **Contribute**, and then **Open Pull Request**. Provide a concise title and description describing your contribution.
61
62
### Contribution Guideline
63
64
- ⭐ Drop a star on the GitHub repository (optional).
65
- Before contributing, please read [`Contributing_Guidelines.md`](Contributing_Guidelines.md) and [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).
66
- Create an issue or propose a feature/bug fix.
67
- Fork the repo, clone it, create a branch, add your changes, commit, and push.
68
- Make a pull request comparing your branch with the main branch of the repository.
69
70
## Usage
71
72
### Command-Line Interface (CLI) Usage
73
74
DNAnalyzer uses CLI arguments instead of standard input. For example:
75
```bash
76
<executable> assets/dna/random/dnalong.fa --amino=ser
77
```
78
or
79
```bash
80
<executable> assets/dna/random/dnalong.fa --amino=ser --min=0 --max=100
81
```
82
To view the help message:
83
```bash
84
<executable> --help
85
86
# Output:
87
Usage: DNAnalyzer [-hrV] --amino=<aminoAcid> [--find=<proteinFile>] [--max=<maxCount>] [--min=<minCount>] DNA
88
  DNA                    The FASTA file to be analyzed.
89
  --amino=<aminoAcid>    The amino acid representing the start of a gene.
90
  --find=<proteinFile>   The DNA sequence to be found.
91
  -h, --help             Show this help message and exit.
92
  --max=<maxCount>       Maximum count of the reading frame.
93
  --min=<minCount>       Minimum count of the reading frame.
94
  -r, --reverse          Reverse the DNA sequence before processing.
95
  -V, --version          Print version information and exit.
96
```
97
98
## Reports
99
100
- [Key Personnel and Knowledge Distribution](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/reports/key-personnel-and-and-knowledge-distribution.pdf)
101
- [Technical Health Overview](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/reports/technical-health-overview.pdf)
102
- [Trend Report](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/reports/trend-report.pdf)
103
104
## Samples
105
106
- [Serine DNAlong](https://github.com/VerisimilitudeX/DNAnalyzer/blob/936181dd714855276ea34f55b94e5b53afc8ef0e/docs/samples/serine-dnalong.md)