--
You received this message because you are subscribed to the Google Groups "Aerogear" group.
To unsubscribe from this group and stop receiving emails from it, send an email to aerogear+unsubscribe@googlegroups.com.
To post to this group, send email to aero...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/CALLRKFhFVgDt1KiAiJ1R22qmcP%2Be_%2Bp3g9hbYnrrRoqXFuvKzQ%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.
At a meeting a few weeks ago, we decided not to centralize all the docs for mobile.next, because:
* keep docs closer to code
* keep docs and code versioned together
* allow devs update docs in same repo as they are working
We also decided not to create sidecar repos, eg a mobile-<service>-docs repo.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/CAO0%2Bn%2BrSV8fD5A4fuTJiKrXoba2MpnXrSB1CLrmV%3DrYgnZ%2BCzA%40mail.gmail.com.
So what you're saying (and I like it) is:
I'm assuming that the release tagging for <service>-apb repo is always the 'version number' we want to communicate to end users?
So what you're saying (and I like it) is:@Paul That's correct.Actually I was thinking if it wouldn't be better to name it mobile-guides (or something similar) instead of mobile-docs? It might be confusing to have so many "docs" around. But I might be wrong, it's just an idea.I'm assuming that the release tagging for <service>-apb repo is always the 'version number' we want to communicate to end users?I'm not sure about the tagging but @David might know the answer?
Hey guys,
Looking at the proposed layout, I am wondering where would be an appropriate place to store auto-generated docs, like javadoc etc. As it is not common practice to store these in the source repo. If we are following the below layout, where do you think would be the best place to keep the likes of Javadocs.
--
You received this message because you are subscribed to the Google Groups "Aerogear" group.
To unsubscribe from this group and stop receiving emails from it, send an email to aerogear+unsubscribe@googlegroups.com.
To post to this group, send email to aero...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/e3ff3061-31b6-4618-a1f7-21e406c45b10%40googlegroups.com.
VOJTĚCH SÁZEL
SENIOR SOFTWARE ENGINEER, RED HAT MOBILE
Remote Czech Republic
vsa...@redhat.com IM: vsazel
On Tue, Feb 13, 2018 at 11:45 AM, <cro...@redhat.com> wrote:
Hey guys,
Looking at the proposed layout, I am wondering where would be an appropriate place to store auto-generated docs, like javadoc etc. As it is not common practice to store these in the source repo. If we are following the below layout, where do you think would be the best place to keep the likes of Javadocs.
As it's being probably generated by Jenkins/CircleCI. I propose that automatically generated docs should be part of the releases page, like as ZIP in here https://github.com/aerogear/mobile-cli/releases.
But we need probably to view them online as well. I was thinking about having it in gh-pages.
You guys probably have more experience with documenting open-source projects, I found only this on StackOverflow:
----
You received this message because you are subscribed to the Google Groups "Aerogear" group.
To unsubscribe from this group and stop receiving emails from it, send an email to aerogear+unsubscribe@googlegroups.com.
To post to this group, send email to aero...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/e3ff3061-31b6-4618-a1f7-21e406c45b10%40googlegroups.com.
--
VOJTĚCH SÁZEL
SENIOR SOFTWARE ENGINEER, RED HAT MOBILE
Remote Czech Republic
vsa...@redhat.com IM: vsazel
You received this message because you are subscribed to the Google Groups "Aerogear" group.
To unsubscribe from this group and stop receiving emails from it, send an email to aerogear+u...@googlegroups.com.
To post to this group, send email to aero...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/CAGTW8rH5S%3DF2EN9wzu3fDps-pYufADV%3DLr9rE8a%2Bznuqc944PQ%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.
-- Paul Wright Mobile Docs (github: finp)
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/CAGTW8rH5S%3DF2EN9wzu3fDps-pYufADV%3DLr9rE8a%2Bznuqc944PQ%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.
[1] https://1-119057815-gh.circle-artifacts.com/0/home/circleci/docs/_preview/aerogear/latest/getting-started/mobile_terminology.html
-- Paul Wright Mobile Docs (github: finp)
--
You received this message because you are subscribed to the Google Groups "Aerogear" group.
To unsubscribe from this group and stop receiving emails from it, send an email to aerogear+unsubscribe@googlegroups.com.
To post to this group, send email to aero...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/e3ff3061-31b6-4618-a1f7-21e406c45b10%40googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/aerogear/CADF%3Dh2sVQEUoTgC%3DO_rxz7Z1WuTwqa%2BsRcM1aeifycxoeb99WA%40mail.gmail.com.