parse-community / Parse-Swift

The Swift SDK for Parse Platform (iOS, macOS, watchOS, tvOS, Linux, Android, Windows)
https://parseplatform.org
MIT License
308 stars 69 forks source link

Remove duplicate docs #420

Open mtrezza opened 2 years ago

mtrezza commented 2 years ago

New Issue Checklist

Issue Description

The docs here contain a lot of copy/paste from the Parse Server repo. This makes the docs difficult to maintain, as info needs be kept in sync. In addition, the copied info is sometimes truncated, which may case misunderstandings and provides less value than the original longer and more detailed docs.

Common docs that are referenced across Parse Platform repos may be best kept in a separate repo, but we currently don't have such a repo, other than maybe the governance repo. Until we have such a common repo or find another approach, individual repos should only reference the docs in the Parse Server repo, not duplicate their information.

Steps to reproduce

For example compare:

Actual Outcome

n/a

Expected Outcome

n/a

Environment

n/a

parse-github-assistant[bot] commented 2 years ago

Thanks for opening this issue!

mtrezza commented 2 years ago

@cbaker6 Do you have a suggestion on how to solve this? Otherwise I would just remove the duplicate parts.

Off topic: The GitHub About section of this repo reads (I rephrased it recently):

The Swift SDK for Parse Platform (iOS, macOS, watchOS, tvOS, Linux, Android)

Are there any docs about how to use the Parse Swift SDK in Android?

cbaker6 commented 2 years ago

Otherwise I would just remove the duplicate parts.

duplicate parts can be removed and/or linked to the server document

Are there any docs about how to use the Parse Swift SDK in Android?

“Windows” needs to be added to this section… There are no docs needed to use for Android or any other OS as they all use SPM. Anyone building swift on another platform should know SPM is available. Any other requirement for other OS’s are in the API docs.

mtrezza commented 2 years ago

“Windows” needs to be added to this section

added

duplicate parts can be removed and/or linked to the server document

ok