I have to write software project documentation for an application which will support both iOS and Android. Each platform has its specific features and the mobile app design and requirements are almost the same.

At first, I thought to include all the requirements in one document by separating the platforms side-by-side.

However, why should android devs see the iOS dev part and vice-versa?

Should I write the document separately for each platform or include it in one document? Which one is good for QAs and for the overall professionalism of the software requirement specification ?

1 Answer 1


Everyone documents a little different but I would say place it into separate documents. I say this because iOS and Android different platforms with different features. This all depends on your scope but scope of a project can change at any time. I feel like it'd would be a bit of a mess.

Let's say Android Dev's scope changes and for some reason now you'll need access to the Phone Contact's Content provider or maybe the addition of a widget? You make the change and ship out the document to all Devs. If I am a iOS Dev why is there a updated documentation telling me that that I'll need access to the Phone Contact's Content Provider(Which is something very android specific)? Or maybe you have to change a piece of your document because the iOS app store denied one of your development practices. The same thing applies and It's a bit confusing. Not to mention if you try to avoid this and decide to make a change in one platform and only update those devs of their change now your documentation is inconsistent and can lead to other problems.

I would assume you have two separate teams? They're writing in two different languages for different mobile application stores with their own rules and regulations as well. It would be simpler and easier to manage if they both had their own documentation.

  • Yes Android and iOS teams are different and they work separately.What about db developers? They should design the db for the app and write services, which document should they use?
    – saakian
    Feb 12, 2014 at 8:17
  • They'll need both. Whatever your app is I'm sure you would want them to sync between the two platforms. So the db would be the same. Your iOS and Android apps would be a presentation layer for your underlying databases/services. They'll most likely expose a JSON API that'll allow each platform to manipulate the data from the database. I say both so the db developers knows how each platform is using the data so they can design the db to make people lives easier across both teams.
    – Mickey Sly
    Feb 12, 2014 at 18:40

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.