[GitHub] [streampipes] flomickl added a comment to the discussion: Documentation Develop Processors

[GitBox <gi...@apache.org>]

GitHub user flomickl added a comment to the discussion: Documentation Develop Processors

> Cool, thanks for starting to collect all the options. Did you also take a look at the "SKD" sections of the documentation? [1] There are already some short descriptions there. Maybe we can expand them there.


Oh I did not know this. Again, a new feature I missed? :-)

> 
 Yes, that was the plan, but for the start it was easier to create a separate doc to get a better overview. The main goal is to add all this information to the doc website in the end; in a more compact way. Maybe in smaller sections ?!?

> We should discuss, where we want to have what kind of information. I like that you made a very detailed overview of all possibilities so that we can see how the current model looks like. But I guess for users this will be overvelming and for us it will be hard to maintain when things change.
> 
> My suggestion would be to include this information in the Javadoc. In the SDK module [2] there is already a lot of JavaDoc, maybe we can check what is missing there and extend it. All other information should be included in the documentation. There, I would especially like to have much more detailed descriptions of the concepts, as you have already started.

Yes, Javadoc sound great. But in my opinion, there is never a good examples part in the Javadoc.

So I would suggest the description part is on the website doc and extend the SDK module or somewhere else?
All table sections could be referenced to the Javadoc. 
The examples should be again in the description section. 
If something big changed, you have to adjust the documentation anyway. But this way it is a good mixture.

What do you think?
Is there already a Javadoc?

> 
> What do you think?
> 
> [1] https://streampipes.apache.org/docs/docs/extend-sdk-functions.html [2] https://github.com/apache/streampipes/tree/dev/streampipes-sdk



GitHub link: https://github.com/apache/streampipes/discussions/1183#discussioncomment-4843450

----
This is an automatically sent email for dev@streampipes.apache.org.
To unsubscribe, please send an email to: dev-unsubscribe@streampipes.apache.org