Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Directory structure for multiple sites should be explained on the docs. #120

Open
2 of 5 tasks
nextgenthemes opened this issue Oct 27, 2017 · 1 comment
Open
2 of 5 tasks

Comments

@nextgenthemes
Copy link

nextgenthemes commented Oct 27, 2017

Submit a feature request or bug report


Suggestion for new/improved documentation

So the recommended directly structure is this:

example.com/      # → Root folder for the project
├── trellis/      # → Your clone of this repository
└── site/         # → A Bedrock-based WordPress site
    └── web/
        ├── app/  # → WordPress content directory (themes, plugins, etc.)
        └── wp/   # → WordPress core (don't touch!)

From what I have read it seems that this (below) is the recommended what for multiple sites. Am I correct about that? I saw a thread dating back to 2015 on your discourse. And this question got asked often. So I suggest to document this so nobody asks it again. I admit I not really read all but ...

websites/      # → Root folder for the project
├── trellis/      # → Your clone of this repository
└── example.com/         # → A Bedrock-based WordPress site
    └── web/
        ├── app/  # → WordPress content directory (themes, plugins, etc.)
        └── wp/   # → WordPress core (don't touch!)
└── another-example.com/         # → A Bedrock-based WordPress site
    └── web/
        ├── app/  # → WordPress content directory (themes, plugins, etc.)
        └── wp/   # → WordPress core (don't touch!)

So if this is the recommended way then why is the root folder of the example structure called like a domain? I think its confusing because the wordpress-sites.yml also suggests that this is the way it should be done.

One could also do this. And then change the Vangrant box IP and have completely separate vagrant boxes? What are the benefits of this kind of setup? Or should that be avoided? Document this?

example.com/      # → Root folder for the project
├── trellis/      # → Your clone of this repository
└── site/         # → A Bedrock-based WordPress site
    └── web/
        ├── app/  # → WordPress content directory (themes, plugins, etc.)
        └── wp/   # → WordPress core (don't touch!)
another-example.com/      # → Root folder for the project
├── trellis/      # → Your clone of this repository
└── site/         # → A Bedrock-based WordPress site
    └── web/
        ├── app/  # → WordPress content directory (themes, plugins, etc.)
        └── wp/   # → WordPress core (don't touch!)

I think in general the docs are very basic. I already gave trellis a test spin but without my already pretty good Linux knowledge I would be lost I think.

@swalkinshaw
Copy link
Member

Agreed these kind of of setups could be better documented. We try and keep it simple with one recommended setup to begin with. But these could be explained in another more advanced section.

To answer your question, both of those setups are completely valid. It entirely depends on your needs. In the first one, your Trellis configuration applies to every site. You could make some changes per site, but it's a little more difficult.

In the second setup, it's obviously easier to customize each site/server but has a lot of duplication.

It also depends what server setup you want. 1 server for n sites, or 1-1 server to site.

Each scenario could be documented 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants