more JSDoc n stuff

src/compiler/output-targets/dist-hydrate-script/bundle-hydrate-factory.ts

@@ -12,12 +12,14 @@ import { updateStencilCoreImports } from '../../transformers/update-stencil-core
 import { getHydrateBuildConditionals } from './hydrate-build-conditionals';
 
 /**
- * TODO
+ * Marshall some Rollup options for the hydrate factory and then pass it to our
+ * {@link bundleOutput} helper
  *
- * @param config
- * @param compilerCtx
- * @param buildCtx
- * @param appFactoryEntryCode
+ * @param config a validated Stencil configuration
+ * @param compilerCtx the current compiler context
+ * @param buildCtx the current build context
+ * @param appFactoryEntryCode an entry code for the app factory
+ * @returns a promise wrapping a rollup build object
  */
 export const bundleHydrateFactory = async (
   config: d.ValidatedConfig,

src/compiler/output-targets/dist-hydrate-script/hydrate-build-conditionals.ts

@@ -7,6 +7,7 @@ import { getBuildFeatures, updateBuildConditionals } from '../../app-core/app-da
  *
  * @param config a validated Stencil configuration
  * @param cmps component metadata
+ * @returns a populated build conditional object
  */
 export const getHydrateBuildConditionals = (config: d.ValidatedConfig, cmps: d.ComponentCompilerMeta[]) => {
   const build = getBuildFeatures(cmps) as d.BuildConditionals;

src/runtime/update-component.ts

@@ -457,8 +457,10 @@ const emitLifecycleEvent = (elm: EventTarget, lifecycleName: string) => {
 };
 
 /**
- * TODO
- * @param elm
+ * Set the hydrated flag on a DOM element
+ *
+ * @param elm a reference to a DOM element
+ * @returns undefined
  */
 const addHydratedFlag = (elm: Element) =>
   BUILD.hydratedClass