Update docs around Universal
- 主要語言
- TypeScript
- 星號
- 7.8k
- 分支
- 2.2k
- 平均合併
- 22 小時 28 分鐘
- 30 天內合併 PR
- 6
描述
Currently the [docs provided](https://github.com/angular/angularfire/blob/master/docs/universal/getting-started.md) for running universal with firebase have not been updated in over 2 years. Comparing the code provided there with the sample project in this repo, it's easy to spot some differences:
- major changes in [server.ts](https://github.com/angular/angularfire/blob/master/sample/server.ts), notably the lack of AppServerModuleNgFactory and a module mapper, the inclusion of a firestore "protos" loader
- the absence of a webpack config file
- the universal cloud function has changed
- package scripts are different
Given the long running issues and ongoing challenges of doing universal with firebase, it would be awesome to have current docs on how to set this up in a way that is proven to work. If you are open to PRs I could open one.
It may also be worth maintaining a separate repo for a sample project that demonstrates serving routes that use firestore data so we can be sure what works when server-side rendering pages that need firestore data. It would be a great reference but also a great testing ground for when new versions of angular or firebase are released.
Thank you!
### Version info
**Angular: 11**
**Firebase: 8.0.0**
**AngularFire: 6.1.4**
**Other (e.g. Ionic/Cordova, Node, browser, operating system):**
### How to reproduce these conditions
n/a
**Steps to set up and reproduce**
n/a
**Sample data and security rules**
n/a
### Debug output
n/a
### Expected behavior
n/a
### Actual behavior
n/a
貢獻指南
研究方向
從 docs/universal/getting-started.md 開始,將其與目前的 sample/server.ts、套件指令碼、webpack 設定和 universal cloud function 進行比較。更新文件,使其與範例專案一致,包括 server.ts 的變更和 Firestore protos loader,然後驗證文件中所述的 Firebase Universal 設定是否能在 repository 目前的結構下運作。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- angular, typescript
- 領域
- documentation, web-dev
- Issue 類型
- 文件
- 難度
- 4/5
- 預估耗時
- 3-5 天
- 活躍度
- 停滯
- 描述清晰度
- 基本清楚
- 新手友好度
- 38/100