Vue build docs out of date, should mention Poi
See original GitHub issueI’m new to Vue, vue-cli, etc, but I was excited to see that “vue build” could prepare a build for production. I was less happy when I saw this, because the main repository readme points me to https://github.com/vuejs/vue-cli/blob/master/docs/build.md to learn about building:
-> vue build
We are slimming down vue-cli to optimize the initial installation by removing the
vue build
command. Check out Poi (https://github.com/egoist/poi) which offers the same functionality!
On the awesome side, I installed Poi, and it works, but I think it would be nice to have documentation here about how to use Poi as the build tool. It seems like Poi can do more than just build though? Can it do everything vue-cli can do? Some words about the relationship between the two tools here would be really appreciated by a noob like me, who is also learning a million other things right now. I want to learn about Poi more, but right now I just need to know how it relates to vue-cli as the replacement build tool.
Thanks.
Issue Analytics
- State:
- Created 6 years ago
- Comments:9 (4 by maintainers)
Top GitHub Comments
@posva Thanks for your reply. I read #589 but I still think the 2.x docs should not tell us to use vue-build when vue-build is no longer a part of the project. True, you run it and it tells you to use Poi, but a few sentences here about what part of poi you need to focus on, I think, would really help. Poi is a deep, deep project and telling us to basically RTFM isn’t a great answer, imho.
@LinusBorg, @posva, I’m agreed with @daveknapik. I just started to use vue-cli and found the section in main readme:
Then I read that docs link and run
vue build Component.vue
command for my component. And what do you think I saw in the console output?What the shame for official docs! I’m sorry for time spent. It would be better if I just got a link to the poi’s documentation on how to use it.
Actually,
vue build
command was removed on 2 of October 2017. Why documentation was not updated yet? Should I make PR to fix docs?