add shared directory configuration, javadocs