diff --git a/ts/editor/FocusTrap.svelte b/ts/editor/FocusTrap.svelte
index 2b9b4e792..e9920ed7e 100644
--- a/ts/editor/FocusTrap.svelte
+++ b/ts/editor/FocusTrap.svelte
@@ -18,6 +18,10 @@ License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html
     }
 </script>
 
+<!--
+@component
+Allows "focusing" an EditingArea, even though it has no open editing inputs.
+-->
 <input bind:this={input} class="focus-trap" readonly tabindex="-1" on:focus />
 
 <style lang="scss">
diff --git a/ts/editor/NoteEditor.svelte b/ts/editor/NoteEditor.svelte
index 957b07616..9f5cce9c2 100644
--- a/ts/editor/NoteEditor.svelte
+++ b/ts/editor/NoteEditor.svelte
@@ -273,6 +273,14 @@ License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html
     setupLifecycleHooks(api);
 </script>
 
+<!--
+@component
+Serves as a pre-slotted convenience component which combines all the common
+components and functionality for general note editing.
+
+Functionality exclusive to specifc note-editing views (e.g. in the browser or
+the AddCards dialog) should be implemented in the user of this component.
+-->
 <div class="note-editor">
     <FieldsEditor>
         <EditorToolbar {size} {wrap} api={toolbar}>