Merge branch 'next' into datarewrite-structures

1 files changed, 20 insertions, 3 deletions

diff --git a/static/components/vevent-block.ts b/static/ts/components/vevent-block.ts
index 9bbb8e7e..90460740 100644
--- a/static/components/vevent-block.ts
+++ b/static/ts/components/vevent-block.ts
@@ -1,3 +1,14 @@
+/**
+ * `<vevent-block />`
+ *
+ * A block in our graphical view.
+ *
+ * Unique in that it works quite differently between the week and month view.
+ *
+ * @category Web Components
+ * @mergeTarget components
+ * @module
+ */
 export { ComponentBlock }
 
 import { ComponentVEvent } from './vevent'
@@ -5,10 +16,16 @@ import { VEvent } from '../vevent'
 import { parseDate, to_local } from '../lib'
 
 
-/* <vevent-block />
+/**
+   A graphical block in the inline view.
 
-   A grahpical block in the week view.
-*/
+   The back-end links what should become these to elements in the sidebar
+   containing extra info, jumping between them using fragment links.
+   That functionality is removed when we replace the non-js fallback children of
+   these elements, but we instead link it to a
+   {@linkcode components/popup-element.PopupElement}
+   containing the detailed information, along with editing controls and more.
+ */
 class ComponentBlock extends ComponentVEvent {
     constructor(uid?: string) {
         super(uid);