# RhinoCommon API with Comment function via.hypothes.is

**URL:** <https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875>\
**Category:** Rhino Developer\
**Created:** [November 17, 2016, 10:57pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875 "2016-11-17T22:57:52Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![Tom\_P](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/tom_p/32/766520_2.png) [@Tom\_P](https://discourse.mcneel.com/u/Tom_P)\
**Post date:** [November 17, 2016, 10:57pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/1 "2016-11-17T22:57:52Z")

</div>

Did somebody else thought about using [hypothes.is](http://hypothes.is) to share Annotations in the RhinoCommon API ?

[https://via.hypothes.is/http://developer.rhino3d.com/api/RhinoCommon/html/N\_Rhino.htm](https://via.hypothes.is/http://developer.rhino3d.com/api/RhinoCommon/html/N_Rhino.htm)

some nice features like groups, ranking, etc…

shall we give it a try ?

Edit:  
and even annotate this side 😉  
[https://via.hypothes.is/https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875](https://via.hypothes.is/https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875)

---

<div class="post-metadata">

**Author:** ![dale](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/dale/32/685184_2.png) [@dale](https://discourse.mcneel.com/u/dale)\
**Post date:** [December 1, 2016, 6:23pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/3 "2016-12-01T18:23:45Z")

</div>

Hi Tom,

I’m not sure what the question is here. Can you explain further?

– Dale

---

<div class="post-metadata">

**Author:** ![Tom\_P](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/tom_p/32/766520_2.png) [@Tom\_P](https://discourse.mcneel.com/u/Tom_P)\
**Post date:** [December 1, 2016, 10:47pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/4 "2016-12-01T22:47:27Z")

</div>

@dale  
dear Dale - thanks for asking.  
I like the idea of having a RhinoCommon-Documentation, that allows comments by the users - or links to this forum or vice versa. as the current documentation does not have this functionality - you can just use hypothes.  
see the small annotation sidebar of above s link.

the question “shall we give it a try” was more addressed to other users - then to the mcneel stuff. But maybe you might like the idea as well.

best tom

 ![](https://global.discourse-cdn.com/mcneel/uploads/default/original/3X/a/c/ac247ebb498f8eeb7019fc9e9937faba494e8e95.png)

---

<div class="post-metadata">

**Author:** ![dale](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/dale/32/685184_2.png) [@dale](https://discourse.mcneel.com/u/dale)\
**Post date:** [December 2, 2016, 4:41pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/5 "2016-12-02T16:41:26Z")

</div>

@dan, do you have any thoughts on this?

---

<div class="post-metadata">

**Author:** ![stevebaer](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/stevebaer/32/473567_2.png) [@stevebaer](https://discourse.mcneel.com/u/stevebaer)\
**Post date:** [December 2, 2016, 4:58pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/6 "2016-12-02T16:58:43Z")

</div>

I don’t think we as “McNeel” should do anything about this. It is up to the users to use this system if they choose, but we will have no control over the commenting system.

---

<div class="post-metadata">

**Author:** ![dan](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/dan/32/481637_2.png) [@dan](https://discourse.mcneel.com/u/dan)\
**Post date:** [December 2, 2016, 5:47pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/7 "2016-12-02T17:47:09Z")

</div>

I agree with Steve. I would only hope that - if the system is useful to those who try it out - they make sure to bring the most helpful comments to our attention (as we may not be aware of what is going on sometimes). If there is something wrong with the documentation, we need to hear about it …by whatever communication channel is best, though we prefer here.

I know that my goal - and I think others here would share it - is to make the canonical documentation ([guides](http://developer.rhino3d.com/guides/), [samples](http://developer.rhino3d.com/samples/), [api references](http://developer.rhino3d.com/api/)) as useful as possible “out-of-the-box.”

---

<div class="post-metadata">

**Author:** ![Tom\_P](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/tom_p/32/766520_2.png) [@Tom\_P](https://discourse.mcneel.com/u/Tom_P)\
**Post date:** [December 2, 2016, 6:14pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/8 "2016-12-02T18:14:06Z")

</div>

@dale @dan @stevebaer  
thanks for your discussion. I came across this idea because i searched for a possibility to remember stuff with certain entries in the api reference. Let me give an example:  
I was checking for discontinuity  
[http://developer.rhino3d.com/api/RhinoCommon/html/T\_Rhino\_Geometry\_Continuity.htm](http://developer.rhino3d.com/api/RhinoCommon/html/T_Rhino_Geometry_Continuity.htm)  
The option i needed i found in Dales answer here

> [@RhinoCommon equivalent of "Explode"](https://discourse.mcneel.com/t/rhinocommon-equivalent-of-explode/21093/8):
>
> The explode command searches for ON::Gsmooth\_continuous discontinuity, which is what we call aesthetic discontinuity. It has a enum value of 12. I don’t believe this is defined in RhinoCommon. Try using this value with Curve.GetNextDiscontinuity.

But enum 12 is not in the rhinocommon documentation.  
It would be great to have a way, that (final) results from this forum get a proper place to be easily accessible. maybe with a (auto-generated) link list - “related topics in discourse”?

---

<div class="post-metadata">

**Author:** ![piac](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/piac/32/673006_2.png) [@piac](https://discourse.mcneel.com/u/piac)\
**Post date:** [December 2, 2016, 6:57pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/9 "2016-12-02T18:57:55Z")

</div>

Hi guys,

> [@Tom\_P](#):
>
> But enum 12 is not in the rhinocommon documentation.

That’s an annoying bug. We should fix it, hopefully _soon_. In this particular case, I think it should also not be documented. I put it on my list: [RH-37054](https://mcneel.myjetbrains.com/youtrack/issue/RH-37054). In general, when such an “magic-number” advice is given, we should try to track it on youtrack and see what we can do about it.

This does not mean that some way of wiki-documenting the API might not be useful.

---

<div class="post-metadata">

**Author:** ![dale](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/dale/32/685184_2.png) [@dale](https://discourse.mcneel.com/u/dale)\
**Post date:** [December 2, 2016, 7:33pm UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/10 "2016-12-02T19:33:53Z")

</div>

> [@piac](#):
>
> We should fix it, hopefully soon.

This enum is included in the WIP…

---

<div class="post-metadata">

**Author:** ![piac](https://sea3.discourse-cdn.com/mcneel/user_avatar/discourse.mcneel.com/piac/32/673006_2.png) [@piac](https://discourse.mcneel.com/u/piac)\
**Post date:** [December 3, 2016, 11:09am UTC](https://discourse.mcneel.com/t/rhinocommon-api-with-comment-function-via-hypothes-is/38875/11 "2016-12-03T11:09:24Z")

</div>

> [@dale](#):
>
> This enum is included in the WIP…

Oh, I see.