[aerogear-dev] [feedhenry-dev] AeroGear Github projects

Daniel Passos dpassos at redhat.com
Wed Jan 3 06:31:29 EST 2018


Hey Paul,

On Wed, Jan 3, 2018 at 8:13 AM, Paul Wright <pwright at redhat.com> wrote:

> Hi Daniel,
>
> I like the idea (I think this is how the docs organization should be
> driven), how about:
>
> As a developer or contributor, I'd like to know what repos are associated
> with the feature/platform I'm planning to develop for.
>
> I think this was the original intention behind the 'Modules' pulldown on
> aerogear.org which, for example, links to https://aerogear.org/sync/.
> Unfortunately, the repos <https://github.com/aerogear/?query=sync> link
> doesn't work as expected for me. (and I'm not sure if changing the link to
> https://github.com/search?q=org%3Aaerogear+sync is a good solution)
>

q instead of search in your query string. Here is an example:

You should use https://github.com/aerogear?q=sync


> As I've said earlier [1], I find aerogear.org difficult to maintain (it's
> now a mishmash of html/markdown/asciidoc, with dependencies I seem to have
> difficulty following [2].
>

I totally agree with you, I know that pain. There is a lot of history
behind of this mess. I also don't like this.


> If there isn't an appetite for changing to asciibinder, I can still help
> reorganize, update and publish documentation, and this seems as good an
> issue as any to start with. How about doing this collation on the wiki
> (using asciidoc):
>
> https://github.com/aerogear/aerogear.org/wiki
>

I'm not a big fan of Asciidoctor, I usually prefer to use Markdown, because
it is more simple and more community driven, but I'm not against to use any
other thing, just wanna use only *one* thing :)

I don't know that is the best approach to solve it. Not sure if a wiki in
the aerogear.org or if we should move the documentation for wiki in each
repo. I only know docs is a little outdated and maintain it is a hell.

Anyway, whatever decision we made count me in to help to update/organize
the docs.


> WDYT?
>
> Paul
>
> [1] https://www.redhat.com/archives/feedhenry-dev/2017-
> December/msg00091.html
>
> [2] https://github.com/aerogear/aerogear.org/pull/714
>
> On 01/02/2018 10:08 PM, Daniel Passos wrote:
>
> I was thinking about have a project to group the repos with the same
> feature/platform, but that is not the GH idea.
>
> I thought project will give us something like https://github.com/aerogear/
> projects/sync and this link will list all sync repos
>
> As I sad, nevermind!
>
> On Tue, Jan 2, 2018 at 7:22 PM, Wei Li <weil at redhat.com> wrote:
>
>> You can have GH project per org - https://github.com/orgs/aero
>> gear/projects. But I don't know why we need it given that we already
>> have Trello & Jira?
>>
>> On Tue, Jan 2, 2018 at 5:47 PM, Daniel Passos <dpassos at redhat.com> wrote:
>>
>>> Hi Paul,
>>>
>>> Nevermind,
>>>
>>> I'd like to create a project to group repos, like:
>>>
>>> Project X
>>>
>>> aerogear-android-x
>>> aerogear-ios-x
>>>
>>> But, GH do it in a different way. Just realized GH project is per repo
>>> not per org
>>>
>>> My mistake. Sorry about that.
>>>
>>>
>>> On Tue, Jan 2, 2018 at 3:40 PM, Paul Wright <pwright at redhat.com> wrote:
>>>
>>>> Hi Daniel,
>>>>
>>>> can you outline why you think it will help?
>>>>
>>>> If there are projects for all platforms and features, won't we end up
>>>> wrangling projects as well as repos?
>>>>
>>>> Note: I'm saying this with true ignorance, I have no idea whether
>>>> that's true or not ;)
>>>>
>>>> Paul
>>>>
>>>> On 01/02/2018 05:16 PM, Daniel Passos wrote:
>>>>
>>>> Hi
>>>>
>>>> I wanna create some Github projects to help us to organize repos on
>>>> AeroGear organization. Wdyt?
>>>>
>>>> I was thinking about create 2 types of projects:
>>>>
>>>>    1. Platforms
>>>>    2. Features
>>>>
>>>> Some examples in my mind:
>>>> Platforms
>>>>
>>>> Android
>>>> iOS
>>>> JS
>>>> Xamarin
>>>> Cordova
>>>> Feature
>>>>
>>>> Website
>>>> Core
>>>> Http
>>>> Push
>>>> OAuth2
>>>> Database
>>>> Security
>>>> Sync
>>>>
>>>> PS: A repo can be in more than one project.
>>>>>>>> --
>>>> -- Passos
>>>>
>>>>
>>>> _______________________________________________
>>>> feedhenry-dev mailing listfeedhenry-dev at redhat.comhttps://www.redhat.com/mailman/listinfo/feedhenry-dev
>>>>
>>>>
>>>> --
>>>> Paul Wright
>>>> Mobile Docs (github: finp)
>>>>
>>>>
>>>
>>>
>>> --
>>> -- Passos
>>>
>>> _______________________________________________
>>> feedhenry-dev mailing list
>>> feedhenry-dev at redhat.com
>>> https://www.redhat.com/mailman/listinfo/feedhenry-dev
>>>
>>>
>>
>>
>> --
>>
>> WEI LI
>>
>> SENIOR SOFTWARE ENGINEER
>>
>> Red Hat Mobile <https://www.redhat.com/>
>>
>> weil at redhat.com    M: +353862393272
>> <https://red.ht/sig>
>>
>
>
>
> --
> -- Passos
>
>
> --
> Paul Wright
> Mobile Docs (github: finp)
>
>


-- 
-- Passos
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20180103/26c95aae/attachment-0001.html 


More information about the aerogear-dev mailing list