-
Notifications
You must be signed in to change notification settings - Fork 483
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Please update the documentation with the newest NG5, Domino & Universal releases #865
Comments
We understand this issue is a sore spot, and I think there is some movement behind the scenes to get this fixed. I myself would love to help plug the gaps in the documentation, and it would be a great help to get your input on the best route. So, please chime in with your opinion on where it would be most useful to store the documentation, keeping in mind that angular.io already contains an excellent "Getting Started with Universal" guide. Options I can think of off the top of my head:
|
The Getting Started is also not updated - https://universal.angular.io/quickstart/ |
@neoswf Setting Universal (server-side rendering) for your current app is not something easy to do since you will get some errors for some different reasons. I suggest you start with a new project and try to add Universal to it. It will give you the basic understanding of how all those stuff works together. also, this article will help you to understand basic concepts of Universal, and this Story on the Angular-cli wiki is very helpful as well. Also, I highly recommend you to start from angular/universal-starter The current problem with the Angular.io universal guide is that it's explaining using universal, using custom webpack, while most of users are using CLI. |
@m98 Your recommendation, angular/universal-starter, really helped me! @CaerusKaru The quickstart probably requires some updating. I'm pretty new to Javascript frameworks in general, so it could be something big I'm missing. I encountered difficulty at 2. Install Dependencies. Particularly, with this line Several errors were thrown here.
Adding
|
@EdwinChua I have the same error, did you find a way to solve it? |
This project is overly opinionated, but does have everything using the latest dependencies! https://github.com/patrickmichalina/fusebox-angular-universal-starter |
@patrickmichalina I tried to install your fusebox-angular-universal-starter
|
i wish i could have a bare angular-universal that just works. It has been several days and I still haven't figured out. https://github.com/angular/universal-starter is also dead and doesn't render server side in |
Could you elaborate? have you opened an issue with a reproduction? It works fine for me. |
hey, sorry I've read again the docs and managed to render |
@intergleam Agreed, we understand that's an issue and it's our primary focus for the immediate |
@f1729 I dropped the idea of converting my app to Universal in Dec, as I did not have much success. However, I came across https://angular.io/guide/universal some time last week, and following the instructions there, it took me only a couple of hours to convert my application (small) to Universal. |
https://universal.angular.io now redirects to the angular.io Universal guide |
It does seem like the Universal SSR Guide on AIO is lacking any mention of Domino. |
Thanks for reporting this issue. This issue is now obsolete due to changes in the recent changes in the docs. |
This issue has been automatically locked due to inactivity. Read more about our automatic conversation locking policy. This action has been performed automatically by a bot. |
The weakest and most problematic part of Universal is its lack of good & updated documentation.
The few tutorials & docs that you guys provided are outdated and after using some of them, you discover that they are no good.
I tried to use Universal and gave up. Code did not work and the overall experience was just bad.
Now, with the release of the Universal's Ng5 highly expected version for third parties scripts support, I was disappointed to see that the documentation does not mention anything about Domino new addition to Universal.
Really. I love Universal. I promoted it like crazy till I started to suffer from problems with Third Party Scripts implementation, and I gave up.
I really wish to return back, but it's impossible for me or many developers in the community to do so, when the documentation is just so hard, or impossible to use.
You want an example? heres some: I saw in NG5 press release that Domino is implemented, and now we can work with jquery, etc. Searching the project code, I could find only 1 line of code mentioning Domino and nothing else. Couldn't find any documentation regarding NG5 new implementations, in fact Universal seems like a frozen project without any father or mother.
Please, take the documentation seriously, because it will define the technology adaptation success, and as it is now, I cannot see how it will succeed.
The text was updated successfully, but these errors were encountered: