I’d like to add comments to the wiki, may I have permissions for that? Thanks in advance, Matt
On 1/18/16, 6:27 PM, "Joe Witt" <[email protected]> wrote: >Very much agreed Dan. I submitted my comments on the wiki. > >On Mon, Jan 18, 2016 at 6:06 PM, dan bress <[email protected]> wrote: >> I just tossed some comments on the wikipage. >> >> TL;DR I took a look at generating docs as part of the build months ago. I >> think its doable, and someone should pursue it. >> >> On Mon, Jan 18, 2016 at 2:38 PM Joe Witt <[email protected]> wrote: >> >>> Oleg, >>> >>> "Yes, there will be breaking changes. Its not a question of IF, but >>> rather WHEN." >>> >>> I disagree. It is always a question of IF. >>> >>> We have to be extremely judicious in the use of breaking changes and >>> we owe the user/developer based excellent justification in such cases. >>> >>> I will comment on the Wiki page for the substance of this particular >>> proposal (documentation generation). >>> >>> Joe >>> >>> On Mon, Jan 18, 2016 at 1:22 PM, Oleg Zhurakousky >>> <[email protected]> wrote: >>> > Josh >>> > >>> > FWIW, let’s use WIKI comments to maintain a discussion. It will be >>> simpler in the end to compile a resolution and move on. >>> > >>> > Yet, I’ll reply here anyway. >>> > Yes, there will be breaking changes. Its not a question of IF, but >>> rather WHEN. >>> > What we can do is make it less painful by introducing certain changes >>> gradually with deprecations and clear communication to the community on >>> what is about to change. Other mechanics could be applied here as well, but >>> before we get into the mechanics, I’d like to see if there are any more >>> ideas, concerns etc, so we can have a join resolution as to what is a >>> sustainable documentation model of the future NiFi, then we can figure out >>> how to get there. >>> > >>> > Cheers >>> > Oleg >>> > >>> >> On Jan 18, 2016, at 1:08 PM, Joshua Davis <[email protected]> >>> wrote: >>> >> >>> >> Oleg, >>> >> >>> >> Interesting document, what impact would it have on existing >>> installations >>> >> of NIFI? >>> >> >>> >> What would be the upgrade path for Custom Processors? >>> >> >>> >> Are we breaking compatibility with the previous way of doing >>> documentation? >>> >> >>> >> Why not create a simple content repository that can hold the >>> documentation >>> >> information? >>> >> >>> >> Is there a plan for multiple languages? >>> >> >>> >> Joshua Davis >>> >> Senior Consultant >>> >> Hortonworks Professional Services >>> >> (407)476-6752 >>> >> >>> >> >>> >> >>> >> >>> >> >>> >> >>> >> On 1/18/16, 12:09 PM, "Oleg Zhurakousky" <[email protected]> >>> >> wrote: >>> >> >>> >>> Guys >>> >>> >>> >>> I¹ve just finished initial draft of the proposal to improve our >>> component >>> >>> documentation mechanisms (e.g., Processors, ControllerServices etc). >>> >>> >>> https://cwiki.apache.org/confluence/display/NIFI/Component+documentation+i >>> >>> mprovements >>> >>> Please give it a read and let¹s get discussion going. >>> >>> >>> >>> Cheers >>> >>> Oleg >>> >> >>> >> >>> > >>>
