doc: some more guidelines