8
8
9
9
< meta name ="viewport " content ="width=device-width, initial-scale=1.0 ">
10
10
11
- < title > Contribution Process — NLP Architect by Intel® AI Lab 0.4.post2 documentation</ title >
11
+ < title > Contribution Process — NLP Architect by Intel® AI Lab 0.5 documentation</ title >
12
12
13
13
14
14
25
25
< script type ="text/javascript " src ="_static/underscore.js "> </ script >
26
26
< script type ="text/javascript " src ="_static/doctools.js "> </ script >
27
27
< script type ="text/javascript " src ="_static/language_data.js "> </ script >
28
+ < script type ="text/javascript " src ="_static/install.js "> </ script >
29
+ < script async ="async " type ="text/javascript " src ="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML "> </ script >
28
30
29
31
< script type ="text/javascript " src ="_static/js/theme.js "> </ script >
30
32
33
35
34
36
< link rel ="stylesheet " href ="_static/css/theme.css " type ="text/css " />
35
37
< link rel ="stylesheet " href ="_static/pygments.css " type ="text/css " />
36
- < link rel ="stylesheet " href ="https://fonts.googleapis.com/css?family=Lato " type ="text/css " />
37
- < link rel ="stylesheet " href ="_static/theme.css " type ="text/css " />
38
+ < link rel ="stylesheet " href ="_static/nlp_arch_theme.css " type ="text/css " />
39
+ < link rel ="stylesheet " href ="https://fonts.googleapis.com/css?family=Roboto+Mono " type ="text/css " />
40
+ < link rel ="stylesheet " href ="https://fonts.googleapis.com/css?family=Open+Sans:100,900 " type ="text/css " />
38
41
< link rel ="index " title ="Index " href ="genindex.html " />
39
42
< link rel ="search " title ="Search " href ="search.html " />
40
43
</ head >
55
58
56
59
57
60
58
- < img src ="_static/nlp_architect_logo_white .png " class ="logo " alt ="Logo "/>
61
+ < img src ="_static/logo .png " class ="logo " alt ="Logo "/>
59
62
60
63
</ a >
61
64
81
84
82
85
83
86
< ul >
84
- < li class ="toctree-l1 "> < a class ="reference internal " href ="main .html "> Home </ a > </ li >
87
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="quick_start .html "> Quick start </ a > </ li >
85
88
< li class ="toctree-l1 "> < a class ="reference internal " href ="installation.html "> Installation</ a > </ li >
86
89
< li class ="toctree-l1 "> < a class ="reference internal " href ="publications.html "> Publications</ a > </ li >
87
90
< li class ="toctree-l1 "> < a class ="reference internal " href ="tutorials.html "> Jupyter Tutorials</ a > </ li >
88
- < li class ="toctree-l1 "> < a class ="reference internal " href ="developer_guide.html "> Developer Guide</ a > </ li >
89
- < li class ="toctree-l1 "> < a class ="reference internal " href ="service.html "> REST Server</ a > </ li >
90
91
< li class ="toctree-l1 "> < a class ="reference internal " href ="model_zoo.html "> Model Zoo</ a > </ li >
91
92
</ ul >
92
93
< p class ="caption "> < span class ="caption-text "> NLP/NLU Models</ span > </ p >
93
94
< ul >
94
- < li class ="toctree-l1 "> < a class ="reference internal " href ="absa .html "> Aspect Based Sentiment Analysis </ a > </ li >
95
- < li class ="toctree-l1 "> < a class ="reference internal " href ="chunker .html "> Sequence Chunker </ a > </ li >
96
- < li class ="toctree-l1 "> < a class ="reference internal " href ="ner_crf .html "> Named Entity Recognition </ a > </ li >
95
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="tagging/sequence_tagging .html "> Sequence Tagging </ a > </ li >
96
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="sentiment .html "> Sentiment Analysis </ a > </ li >
97
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="bist_parser .html "> Dependency Parsing </ a > </ li >
97
98
< li class ="toctree-l1 "> < a class ="reference internal " href ="intent.html "> Intent Extraction</ a > </ li >
98
- < li class ="toctree-l1 "> < a class ="reference internal " href ="np_segmentation.html "> Noun Phrase Semantic Segmentation</ a > </ li >
99
- < li class ="toctree-l1 "> < a class ="reference internal " href ="bist_parser.html "> BIST Dependency Parser</ a > </ li >
100
- < li class ="toctree-l1 "> < a class ="reference internal " href ="word_sense.html "> Most Common Word Sense</ a > </ li >
101
- < li class ="toctree-l1 "> < a class ="reference internal " href ="np2vec.html "> Noun Phrase to Vec</ a > </ li >
102
- < li class ="toctree-l1 "> < a class ="reference internal " href ="supervised_sentiment.html "> Supervised Sentiment</ a > </ li >
103
- < li class ="toctree-l1 "> < a class ="reference internal " href ="reading_comprehension.html "> Reading Comprehension</ a > </ li >
104
- < li class ="toctree-l1 "> < a class ="reference internal " href ="memn2n.html "> End-to-End Memory Networks for Goal Oriented Dialogue</ a > </ li >
105
- < li class ="toctree-l1 "> < a class ="reference internal " href ="tcn.html "> TCN Language Model</ a > </ li >
106
- < li class ="toctree-l1 "> < a class ="reference internal " href ="crosslingual_emb.html "> Unsupervised Crosslingual Embeddings</ a > </ li >
107
- < li class ="toctree-l1 "> < a class ="reference internal " href ="cross_doc_coref.html "> Cross Document Co-Reference</ a > </ li >
108
- < li class ="toctree-l1 "> < a class ="reference internal " href ="identifying_semantic_relation.html "> Semantic Relation Identification</ a > </ li >
99
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="lm.html "> Language Models</ a > </ li >
100
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="information_extraction.html "> Information Extraction</ a > </ li >
101
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="transformers.html "> Transformers</ a > </ li >
102
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="archived/additional.html "> Additional Models</ a > </ li >
103
+ </ ul >
104
+ < p class ="caption "> < span class ="caption-text "> Optimized Models</ span > </ p >
105
+ < ul >
106
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="quantized_bert.html "> Quantized BERT</ a > </ li >
107
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="transformers_distillation.html "> Transformers Distillation</ a > </ li >
109
108
< li class ="toctree-l1 "> < a class ="reference internal " href ="sparse_gnmt.html "> Sparse Neural Machine Translation</ a > </ li >
110
109
</ ul >
111
110
< p class ="caption "> < span class ="caption-text "> Solutions</ span > </ p >
114
113
< li class ="toctree-l1 "> < a class ="reference internal " href ="term_set_expansion.html "> Set Expansion</ a > </ li >
115
114
< li class ="toctree-l1 "> < a class ="reference internal " href ="trend_analysis.html "> Trend Analysis</ a > </ li >
116
115
</ ul >
117
- < p class ="caption "> < span class ="caption-text "> Pipelines</ span > </ p >
118
- < ul >
119
- < li class ="toctree-l1 "> < a class ="reference internal " href ="spacy_bist.html "> Spacy-BIST Parser</ a > </ li >
120
- < li class ="toctree-l1 "> < a class ="reference internal " href ="spacy_np_annotator.html "> Spacy-NP Annotator</ a > </ li >
121
- </ ul >
122
116
< p class ="caption "> < span class ="caption-text "> For Developers</ span > </ p >
123
117
< ul >
124
- < li class ="toctree-l1 "> < a class ="reference internal " href ="api.html "> API</ a > </ li >
118
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="generated_api/nlp_architect_api_index.html "> nlp_architect API</ a > </ li >
119
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="service.html "> REST Server</ a > </ li >
120
+ < li class ="toctree-l1 "> < a class ="reference internal " href ="developer_guide.html "> Developer Guide</ a > </ li >
125
121
</ ul >
126
122
127
123
187
183
< div class ="section " id ="contribution-process ">
188
184
< h1 > Contribution Process< a class ="headerlink " href ="#contribution-process " title ="Permalink to this headline "> ¶</ a > </ h1 >
189
185
< ol class ="arabic simple ">
190
- < li > < p > File an issue (to track your contribution):</ p >
191
- < ul class ="simple ">
192
- < li > < p > Create an issue on GitHub:
193
- < a class ="reference external " href ="https://github.com/NervanaSystems/nlp-architect/issues "> https://github.com/NervanaSystems/nlp-architect/issues</ a > </ p > </ li >
186
+ < li > File an issue (to track your contribution):< ul >
187
+ < li > Create an issue on GitHub:
188
+ < a class ="reference external " href ="https://github.com/NervanaSystems/nlp-architect/issues "> https://github.com/NervanaSystems/nlp-architect/issues</ a > </ li >
194
189
</ ul >
195
190
</ li >
196
- < li > < p > Clone and/or update your checked out copy of nlp-architect to ensure you have the
197
- most recent commits from the master branch:</ p > </ li >
191
+ < li > Fork NLP Architect and/or update your checked out copy of
192
+ nlp-architect to ensure you have the
193
+ most recent commits from the master branch, for example:</ li >
198
194
</ ol >
199
195
< blockquote >
200
196
< div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > git clone https://github.com/NervanaSystems/nlp-architect.git
@@ -206,43 +202,42 @@ <h1>Contribution Process<a class="headerlink" href="#contribution-process" title
206
202
</ div >
207
203
</ div > </ blockquote >
208
204
< ol class ="arabic simple " start ="3 ">
209
- < li > < p > Create a new feature branch for your work and switch to it. Give it a
210
- meaningful name related to the task(s) at hand:</ p > </ li >
205
+ < li > Create a new feature branch for your work and switch to it. Give it a
206
+ meaningful name related to the task(s) at hand:</ li >
211
207
</ ol >
212
208
< blockquote >
213
209
< div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > git checkout -b my_new_feature_branch
214
210
</ pre > </ div >
215
211
</ div >
216
212
</ div > </ blockquote >
217
213
< ol class ="arabic simple " start ="4 ">
218
- < li > < p > Ideally you’d start by creating one or more unit tests with the
214
+ < li > Ideally you’d start by creating one or more unit tests with the
219
215
functionality you expect your new feature to perform. These should reside
220
216
under the appropriate tests subdirectory of whatever you are changing.
221
217
Then hack away at the code until you feel your feature is complete. Once
222
- satisfied, run the code through the following checks:</ p > </ li >
218
+ satisfied, run the code through the following checks:</ li >
223
219
</ ol >
224
220
< blockquote >
225
- < div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > nlp_architect < span class =" nb " > test </ span > < span class ="c1 "> # ensure all are OK</ span >
226
- nlp_architect style < span class ="c1 "> # ensure there are no style related issues</ span >
221
+ < div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > ./scripts/run_tests.sh < span class ="c1 "> # ensure all are OK</ span >
222
+ ./scripts/check_style.sh < span class ="c1 "> # ensure there are no style related issues</ span >
227
223
</ pre > </ div >
228
224
</ div >
229
225
</ div > </ blockquote >
230
226
< ol class ="arabic simple " start ="5 ">
231
- < li > < p > If necessary you may want to update and/or rebuild the documentation.
227
+ < li > If necessary you may want to update and/or rebuild the documentation.
232
228
This all exists under docs-source/source and is in
233
- < a class ="reference external " href ="http://sphinx-doc.org/rest.html "> Sphinx reStructuredText format</ a > :</ p > </ li >
229
+ < a class ="reference external " href ="http://sphinx-doc.org/rest.html "> Sphinx reStructuredText format</ a > :</ li >
234
230
</ ol >
235
231
< blockquote >
236
- < div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > < span class ="nb "> cd</ span > scripts/
237
- sh create_docs.sh < span class ="c1 "> # builds the doc and starts a local server directly</ span >
232
+ < div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > ./scripts/create_docs.sh < span class ="c1 "> # builds the doc and starts a local server directly</ span >
238
233
</ pre > </ div >
239
234
</ div >
240
235
</ div > </ blockquote >
241
236
< ol class ="arabic simple " start ="6 ">
242
- < li > < p > Commit your changes and push your feature branch to your GitHub fork. Be
237
+ < li > Commit your changes and push your feature branch to your GitHub fork. Be
243
238
sure to add a descriptive message and reference the GitHub issue associated
244
239
with your task (ex. #1). You will also want to rebase your commits down to
245
- a single sensible commit to make things clean for the merge process:</ p > </ li >
240
+ a single sensible commit to make things clean for the merge process:</ li >
246
241
</ ol >
247
242
< blockquote >
248
243
< div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > git add my_updated_files
@@ -252,31 +247,15 @@ <h1>Contribution Process<a class="headerlink" href="#contribution-process" title
252
247
</ div >
253
248
</ div > </ blockquote >
254
249
< ol class ="arabic simple " start ="7 ">
255
- < li > < p > Create a new pull request to get your feature branch merged into master for
256
- others to use. You’ll first need to ensure your feature branch contains the
257
- latest changes from master. Furthermore, internal devs will need to assign
258
- the request to someone else for a code review. You must also ensure there
259
- are no errors when run through the items defined in step 4.</ p > </ li >
260
- </ ol >
261
- < blockquote >
262
- < div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > < span class ="c1 "> # (external contribs): make a new pull request:</ span >
263
- https://github.com/NervanaSystems/nlp-architect/pulls
264
-
265
- < span class ="c1 "> # merge latest master changes into your feature branch</ span >
266
- git fetch origin
267
- git checkout master
268
- git pull origin master
269
- git checkout my_new_feature_branch
270
- git merge master < span class ="c1 "> # you may need to manually resolve any merge conflicts</ span >
271
- </ pre > </ div >
272
- </ div >
273
- </ div > </ blockquote >
274
- < ol class ="arabic simple " start ="8 ">
275
- < li > < p > If there are issues you can continue to push commits to your feature branch
250
+ < li > Create a new < a class ="reference external " href ="https://github.com/NervanaSystems/nlp-architect/pulls "> pull request</ a >
251
+ to get your feature branch merged into master for others to use.
252
+ You’ll first need to ensure your feature branch contains the latest changes from
253
+ master.</ li >
254
+ < li > If there are issues you can continue to push commits to your feature branch
276
255
by following step 6. They will automatically be added to this same merge
277
- request.</ p > </ li >
278
- < li > < p > Once your change has been successfully merged, you can remove the source
279
- branch and ensure your local copy is up to date:</ p > </ li >
256
+ request.</ li >
257
+ < li > Once your change has been successfully merged, you can remove the source
258
+ branch and ensure your local copy is up to date:</ li >
280
259
</ ol >
281
260
< blockquote >
282
261
< div > < div class ="highlight-bash notranslate "> < div class ="highlight "> < pre > < span > </ span > git fetch origin
@@ -288,7 +267,7 @@ <h1>Contribution Process<a class="headerlink" href="#contribution-process" title
288
267
</ div >
289
268
</ div > </ blockquote >
290
269
< ol class ="arabic simple " start ="10 ">
291
- < li > < p > Give yourself a high five for a job well done!</ p > </ li >
270
+ < li > Give yourself a high five for a job well done!</ li >
292
271
</ ol >
293
272
</ div >
294
273
0 commit comments