git.net

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Fineract CN - API Documentation


Hello Isaac, Karthik and others,

Do you think we need a separate repo which contains the upto date API
documentation for all Fineract CN services?
If we do this, then moving forward, we will have periodically update this
repo as soon as an API is created and as features are added.

Do you think it will be too much work for developers to be manually copying
API docs around? I will like your opinion on this.

Or Maybe we just request a subdomain such as
fineract-cn-api.fineract.apache.org from Apche Infra and update it
periodically with new changes. What do you think?

Thanks.
Awasum

On Thu, Sep 27, 2018 at 6:42 PM Karthik Ananthakrishnan
<karthik.a@xxxxxxxxxxxxxxxx.invalid> wrote:

> Hello Issac,
>
> Ran the tests successfully and the snippets got generated in the snippets
> folder. I created as empty ascii file which i think is wrong. I will check
> the link you have provided and try. Is it possible to send me the
> asciidoc.adoc file that you have used.? Will come back if we needed a call
> to sort this.
>
> Thanks,
> Karthik
>
> On Thu, Sep 27, 2018 at 7:01 PM Isaac Kamga <isaac.kamga@xxxxxxxxx> wrote:
>
> > Hello Karthik,
> >
> > There are 3 steps involved in getting the API Docs generated. At which
> step
> > did you have issues ? Did you successfully run the unit tests, use an
> > asciidoc.adoc
> > <https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/> file to
> > reference the snippets before running `gradle asciidoctor` ? You need to
> > follow the steps in that order to make it work.
> >
> > Ensure you have the right version of gradle, try again and provide
> feedback
> > here. We can set up a call if you like.
> >
> > Cheers,
> > Isaac Kamga.
> >
> > On Tue, Sep 25, 2018 at 7:31 PM Karthik Ananthakrishnan
> > <karthik.a@xxxxxxxxxxxxxxxx.invalid> wrote:
> >
> > > Dear All,
> > >
> > > I was following the steps in the below link to generate API
> documentation
> > > in Fineract CN.
> > > Link:
> > >
> >
> https://cwiki.apache.org/confluence/display/FINERACT/Apache+Fineract+CN+API+Documentation
> > >
> > > When I ran Asciidoctor the documentation is not getting generated. A
> HTML
> > > file with timestamp is getting generated.
> > >
> > > [image: AsciiDoctor.png]
> > >
> > > c:\All\fineractcn\fineract-cn-accounting\component-test>gradle
> > asciidoctor
> > > > Task :asciidoctor
> > > io/console not supported; tty will not be manipulated
> > >
> > > Deprecated Gradle features were used in this build, making it
> > incompatible
> > > with Gradle 5.0.
> > > Use '--warning-mode all' to show the individual deprecation warnings.
> > > See
> > >
> >
> https://docs.gradle.org/4.10.1/userguide/command_line_interface.html#sec:command_line_warnings
> > >
> > > BUILD SUCCESSFUL in 1m 32s
> > > 1 actionable task: 1 executed
> > >
> > > Can someone help me understand what i am missing.?
> > >
> > > Thanks,
> > > Karthik
> > >
> >
>