The issue
We currently have android
documentation and android-gradle
documentation as separate documentations. Both document android-gradle
to some extent.
What is the Stackoverflow guidelines for cases like these? Should they be merged? Should we actively encourage splitting arguments into sub-topics?
I'm using android
as an example, this apply to any major tag with lot of arguments (and sub-tags) related to it.
To those unfamiliar with Android
gradle
is a build / dependency management tool more or less like Maven, somewhat like make
in C
. This can be used to build many different types of software with many different languages, and is rightfully a separate tag that deserves its own documentation. Nothing to argue here.
android-gradle
is a gradle plugin, created and maintained by Google, that provides the means to build, sign, and configure Android applications and libraries on top of gradle
.
Duplicated effort
I think they DO makes sense as separate tags for stackoverflow. I'm not so sure about documentation.
There are many topics related to android-gradle
to be covered and they deserve to be documented.
While android
applications and libraries can be written without android-gradle
(almost no one does that) the opposite can't be said: there's no android-gradle
without android
, it simply makes no sense.
If you look at the two documentations you'll see there are many duplicated topics, searching gradle
inside the android
documentation show there are many topics about it.
There was a discussion about this yesterday on the documentation chat, it started with my message here and went on for a while between me, @Shog9 @DanielNugent, @Makoto, and later @Onur and @TravisJ. The conclusion of this discussion was that this is something that needs to be discussed in a meta.
Decision to be made
I also think the discussion is not limited to Android vs Android Gradle but in general to situation like this one.
The community should give a clear guidelines on how to handle cases like this choosing between:
android
andandroid-gradle
makes sense as separate documentations: thus any topic aboutandroid-gradle
should be rejected in android / moved toandroid-gradle
android
andandroid-gradle
DO NOT makes sense as separate documentations: all topics should be merged intoandroid
and the creation ofandroid-gradle
discouraged
As a reference, a similar argument has been brought up about java
and java-8
. However the situation here is not the same, android-gradle
is not a version of android, it is a tool you can use to build android application that wouldn't exist without android
.
Related Feature requests
Whichever decision the community make I think we need a manner to move documentation topics from one documentation to the other. Possibly allowing merging documentations. Follow this feature request.
If the decision is to merge them together I think we also need some way of sectioning the documentation into big topics that can have their specific maintainers / subscribers. Follow this feature request.