Comments (11)
I'm not sure I understand what you mean. The diagram has the text v0.9.0
on it already.
from android-lifecycle.
why not storing changes in the tags, and viewing the Tags/Releases pages (https://github.com/xxv/android-lifecycle/tags), as done e.g here: https://github.com/botherder/detekt/tags ?
oddly enough, the diagram shows a version number, but there are no tags...
from android-lifecycle.
This is a matter of taste. I prefer a plain text file such as CHANGELOG.md
since it allows me to move the repository to any place while taking the changelog with me. GitHub release tags are nice but can only be used with this service.
from android-lifecycle.
I added a tag for the one version I've got now and will add more as more revisions get made. I'm not going to add a CHANGELOG.md
, though, as that's what commit messages and/or tag messages are for.
from android-lifecycle.
Please also add the tag to the graphic.
from android-lifecycle.
Awesome! Sorry, I did not see it.
from android-lifecycle.
exactly - a CHANGELOG
document is just a duplicated effort; and carrying whatever around can be done far more efficiently by carrying e.g. a git bundle, then you have everything.
plus, the changelog is actually what GitHub produces when showing the release page (https://github.com/xxv/android-lifecycle/releases)
from android-lifecycle.
I consider a CHANGELOG
a well-formed summary of the most important changes. It is - so to say - a textual description of the public interface for other developers. Commit messages contain much more detail and not all these information are of interest for "users".
from android-lifecycle.
You are right - except that that changelog summary can be written in a tag.
but indeed, if there is a need to provide the info to the end user (and I do not refer to a developer, but e.g. a user consulting a website) , then some kind of file is needed.
if the intention is to present CHANGELOG info to a developer, the tag is one of the few places to store that info.
but agreed, the inconvenience is that the changelog info is not available without Git. but someone who cannot use Git will not be able to use the repository, so that's not a real issue.
from android-lifecycle.
Please do not mistake GitHub for Git. You can put the notes in:
- CHANGELOG.md (finally added to the Git repository)
- Git tags (part of the Git repository)
- GitHub release notes (not part of the Git repository)
Only the first and the second will go with the repository. The last one will stay at github.com.
from android-lifecycle.
Ah yes, I didn't even think of GitHub - but that's indeed yet another factor :-)
from android-lifecycle.
Related Issues (20)
- add call to `Activity.onDetachedFromWindow`
- Fragment#onActivityResult()
- Samsung made lifecycle changes HOT 3
- Consider adding View/ViewGroup lifecycles HOT 1
- Service Lifecycle HOT 2
- Add DialogFragment lifecycle HOT 1
- onActivityResult() actually is called before onRestart() then onStart() HOT 7
- onSaveInstanceState() vs onRestoreInstanceState() HOT 1
- show sequence of Fragment in an Activity HOT 1
- onCreateOptionsMenu is called before onResume HOT 3
- Explanation about when does onActivityCreated method not called HOT 1
- Multi-window mode HOT 2
- Bug HOT 3
- Add onCreateAnimation callback
- onPostCreate() not called as shown
- onSaveInstanceState() of Activity is called before onStop(), not onDestroy()
- missing onActivityResult in fragment lifecycle HOT 1
- onActivityResult is called after onRestoreInstanceStatus
- 没有生命周期
- Clarification: onCreateOptionMenu() called ones but onPrepareOptionMenu() every time HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from android-lifecycle.