DOC mention clearly how argNorm CLI outputs are changing with the arg…

…Norm version number being added as a comment on top of files

CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+#### argNorm version in outputs from CLI
+The version of argNorm used for normalization is now added to the top of argNorm tsv outputs when generated using the CLI.  For example, 
+
+~~~
+# argNorm version: 0.6.0
+input_sequence_id	input_file_name	gene_symbol	gene_name	reference_database_id ...
+. REST OF ARG ANNOTATION OUTPUT TSV TABLE
+.
+.
+~~~
+
+> **NOTE: This is only if argNorm is used on the CLI, if you used argNorm's normalizers there will be no comment with the argNorm version**
+ 
+> **NOTE: THIS WILL BREAK ANY PREVIOUS SCRIPTS ANALYZING ARGNORM CLI OUTPUTS BEFORE THIS UPDATE! PLEASE USE THE `skiprows=1` ARGUMENT WHEN LOADING ARGNORM OUTPUT DATAFRAMES TO IGNORE THE COMMENT WITH THE ARGNORM VERSION AS SHOWN BELOW:**
+> ```
+> import pandas as pd
+> df = pd.read_csv(<PATH TO ARGNORM OUTPUT>, sep='\t', skiprows=1)
+> ```
+
 ## 0.6.0 - 21 August 2024
 
 #### GROOT support

README.md

@@ -138,7 +138,24 @@ The following columns are added to the tsv outputs of ARG annotation tools:
 | `confers_resistance_to`      | ARO accessions of drugs to which ARGs confer resistance to                       |
 | `resistance_to_drug_classes` | ARO accessions of drugs classes to which drugs in `confers_resistance_to` belong |
 
-A comment is added to the very top of the ARG annotation tool outputs specifying the argNorm version used. For example: '# argNorm version: 0.6.0'
+A comment is added to the very top of the ARG annotation tool outputs specifying the argNorm version used if ran on the command line. For example:
+
+~~~
+# argNorm version: 0.6.0
+input_sequence_id	input_file_name	gene_symbol	gene_name	reference_database_id ...
+. REST OF ARG ANNOTATION OUTPUT TSV TABLE
+.
+.
+~~~
+
+> **NOTE: This is only if argNorm is used on the CLI, if you used argNorm's normalizers there will be no comment with the argNorm version**
+ 
+> **NOTE: THIS WILL BREAK ANY PREVIOUS SCRIPTS ANALYZING ARGNORM CLI OUTPUTS BEFORE THIS UPDATE! PLEASE USE THE `skiprows=1` ARGUMENT WHEN LOADING ARGNORM OUTPUT DATAFRAMES TO IGNORE THE COMMENT WITH THE ARGNORM VERSION AS SHOWN BELOW:**
+> ```
+> import pandas as pd
+> df = pd.read_csv(<PATH TO ARGNORM OUTPUT>, sep='\t', skiprows=1)
+> ```
+
 
 ## Example 1: argNorm as a command line tool
 

docs/index.md

@@ -137,7 +137,24 @@ The following columns are added to the tsv outputs of ARG annotation tools:
 | `confers_resistance_to`      | ARO accessions of drugs to which ARGs confer resistance to                       |
 | `resistance_to_drug_classes` | ARO accessions of drugs classes to which drugs in `confers_resistance_to` belong |
 
-A comment is added to the very top of the ARG annotation tool outputs specifying the argNorm version used. For example: '# argNorm version: 0.6.0'
+A comment is added to the very top of the ARG annotation tool outputs specifying the argNorm version used if ran on the command line. For example:
+
+~~~
+# argNorm version: 0.6.0
+input_sequence_id	input_file_name	gene_symbol	gene_name	reference_database_id ...
+. REST OF ARG ANNOTATION OUTPUT TSV TABLE
+.
+.
+~~~
+
+> **NOTE: This is only if argNorm is used on the CLI, if you used argNorm's normalizers there will be no comment with the argNorm version**
+ 
+> **NOTE: THIS WILL BREAK ANY PREVIOUS SCRIPTS ANALYZING ARGNORM CLI OUTPUTS BEFORE THIS UPDATE! PLEASE USE THE `skiprows=1` ARGUMENT WHEN LOADING ARGNORM OUTPUT DATAFRAMES TO IGNORE THE COMMENT WITH THE ARGNORM VERSION AS SHOWN BELOW:**
+> ```
+> import pandas as pd
+> df = pd.read_csv(<PATH TO ARGNORM OUTPUT>, sep='\t', skiprows=1)
+> ```
+
 
 ## Example 1: argNorm as a command line tool