diff --git a/documentation.py b/documentation.py
index 57b91a9..68d1fc0 100644
--- a/documentation.py
+++ b/documentation.py
@@ -97,6 +97,10 @@ class Docs():
                     else:
                         yaml_data[key] = ""
 
+                # many people remove unused pins in input / output / bidirectional
+                for key in ['inputs', 'outputs', 'bidirectional']:
+                    yaml_data[key].extend((8 - len(yaml_data[key])) * ['n/a'])
+
                 # now build the doc & print it
                 try:
                     doc = (doc_template
@@ -107,6 +111,7 @@ class Docs():
                     fh.write(doc)
                     fh.write("\n\clearpage\n")
                 except IndexError:
+                    import ipdb; ipdb.set_trace()
                     logging.warning("missing pins in info.yaml, skipping")
 
             # ending