SentenceRecognizer - usage example is wrong

[Oxi84]

I do not really understand why would you write a 5 page guide to a software that does not actually say how to use this software. I mean code an examples. This   page - https://spacy.io/api/sentencerecognizer.  the following seemed like an incomplete example, but actually it does not work.

import spacy
nlp = spacy.load("en_core_web_sm")
senter = nlp.add_pipe("senter")
doc = nlp("This is a sentence.")

ValueError: [E007] 'senter' already exists in pipeline. Existing names: ['tok2vec', 'tagger', 'parser', 'senter', 'attribute_ruler', 'lemmatizer', 'ner']

[svlandeg]

Hi,

I do not really understand why would you write a 5 page guide to a software that does not actually say how to use this software. I mean code an examples. This page - https://spacy.io/api/sentencerecognizer.

The spaCy documentation consists of two main parts: the usage docs and the API docs. You want to start with the "usage" pages, in particular the page about Language Processing Pipelines. You'll find that throughout our documentation, we've inserted plenty of working code examples. The API docs are mainly for reference to more experienced users who want to know more about the specific ins and outs of the library.

the following seemed like an incomplete example, but actually it does not work.

import spacy
nlp = spacy.load("en_core_web_sm")
senter = nlp.add_pipe("senter")
doc = nlp("This is a sentence.")

This code does not work because en_core_web_sm already has a senter component - as the error message clearly points out. If that code example would appear verbatim in the documentation, we'll be happy to adjust it. However I was unable to find it. Can you point me towards the exact location where you got this from?

Finally, I'd like to point out that we spend a lot of time and effort into writing this documentation. We're always open for constructive feedback on how to improve the docs for our users. However, your original post comes across as unnecessarily rude and disrepectful, so I'd like to ask you to please engage more constructively in future conversations. You can find spaCy's code of conduct here.

[Oxi84]

I know you took a lot of time into making software and documentation. I did not want to be rude of course, just pointing out you need examples of software usage, so people could use it. Sorry for that. Just want to make helpful suggestions.

This example is on this page: https://spacy.io/api/sentencerecognizer, just right of this line
SentenceRecognizer.call method

doc = nlp("This is a sentence.")
senter = nlp.add_pipe("senter")
# This usually happens under the hood
processed = senter(doc)

Thanks

[svlandeg]

Right. This example will work when you use for instance

from spacy.lang.en import English
nlp = English()

[svlandeg]

By the way - you might also be interested in having a look at our free interactive course, which will get you going with the basic concepts more quickly: https://course.spacy.io/en