Changes for first staged draft of EAP reference (#939)

* Adding required tags to page template.

* Adding formatting and fixing typo discovered in internal review.

* More fixes/additions discovered in internal review.

* Fixing format of toc.yaml file.

* Adding EAP TOC and index top matter.

* Refine TOC, fix paths in template, attempt to hide params.

* Doing all possible to make this YAML valid.  VSCode extensions believe that it is.

Author: egilmorez

docgen/content-sources/v2/HOME.md

@@ -1,8 +1,8 @@
 # Firebase Functions v2 SDK Reference
 
-The `firebase-functions` package provides an SDK for defining Cloud Functions for Firebase.
+This package provides an SDK for defining Cloud Functions for Firebase v2.
 
-To get started using Cloud Functions, see
-[Get started: write, test, and deploy your first functions](/docs/functions/get-started).
+To get started using Cloud Functions v2, see
+the early access guide you were provided when you joined the EAP program.
 
-For source code, see the [Cloud Functions for Firebase GitHub repo](https://github.com/firebase/firebase-functions).
+**Important:** This API reference is confidential. Do not share or discuss until authorized to do so.

docgen/content-sources/v2/toc.yaml

@@ -1,34 +1,36 @@
 toc:
-  - title: functions
-    path: /docs/functions/alpha/v2.html
-  - title: functions.core
+  - title: 'functions'
+    path: /docs/functions/alpha/index.html
+  - title: 'functions.core'
     path: /docs/functions/alpha/v2_core.html
     section:
-      - title: functions.CloudEvent
-        path: /docs/functions/alpha/v2_core.cloudevent.html
-      - title: functions.CloudFunction
-        path: /docs/functions/alpha/v2_core.cloudfunction.html
-  - title: functions.https
+      - title: 'Functions v2'
+        path: /docs/functions/alpha/v2.html
+      - title: 'functions.CloudEvent'
+        path: /docs/functions/alpha/v2_core.CloudEvent.html
+      - title: 'functions.CloudFunction'
+        path: /docs/functions/alpha/v2_core.CloudFunction.html
+  - title: 'functions.https'
     path: /docs/functions/alpha/v2_providers_https.html
     section:
-      - title: functions.https.options
-        path: /docs/functions/alpha/v2_providers_https.httpsoptions.html
+      - title: 'functions.https.CallableFunction'
+        path: /docs/functions/alpha/v2_providers_https.CallableFunction.html
+      - title: 'functions.https.options'
+        path: /docs/functions/alpha/v2_providers_https.HttpsOptions.html
   - title: 'functions.logger'
     path: /docs/functions/alpha/logger.html
     section:
       - title: 'LogEntry'
         path: /docs/functions/alpha/logger.LogEntry.html
-  - title: functions.options
+  - title: 'functions.options'
     path: /docs/functions/alpha/v2_options.html
     section:
-      - title: functions.options.GlobalOptions
-        path: /docs/functions/alpha/v2_options.globaloptions.html
-      - title: functions.options.EventHandlerOptions
-        path: /docs/functions/alpha/v2_options.eventhandleroptions.html
-  - title: functions.params
-    path: /docs/functions/alpha/v2_params.html
+      - title: 'functions.options.GlobalOptions'
+        path: /docs/functions/alpha/v2_options.GlobalOptions.html
+      - title: 'functions.options.EventHandlerOptions'
+        path: /docs/functions/alpha/v2_options.EventHandlerOptions.html
   - title: 'functions.pubsub'
-    path: /docs/functions/v2_providers_pubsub.html
+    path: /docs/functions/alpha/v2_providers_pubsub.html
     section:
       - title: 'Message'
         path: /docs/functions/alpha/v2_providers_pubsub.Message.html

docgen/theme/layouts/default.hbs

@@ -5,8 +5,8 @@
     <meta http-equiv="X-UA-Compatible" content="IE=edge">
     <meta name="hide_page_heading" value="true" />
     <meta name="project_path" value="/_project.yaml" />
-    <meta name="book_path" value="/docs/reference/_book.yaml" />
-    <meta name="gtm_var" data-key="docType" data-value="reference">
+    <meta name="book_path" value="/docs/_book.yaml" />
+    <meta name="gtm_var" data-key="docType" data-value="how-to">
     <meta name="page_type" value="reference" />
     <meta name="translation" value="disabled" />
     <title>{{#ifCond model.name '==' project.name}}{{project.name}}{{else}}{{model.name}} | {{project.name}}{{/ifCond}}</title>

src/v2/params/index.ts

@@ -1,3 +1,4 @@
+/** @hidden */
 import {
   BooleanParam,
   FloatParam,

src/v2/params/types.ts

@@ -1,3 +1,4 @@
+/** @hidden */
 type ParamValueType = 'string' | 'list' | 'boolean' | 'int' | 'float' | 'json';
 
 export interface ParamSpec<T = unknown> {