Hey everyone! I find that a significant source of ...
# guide
d
Hey everyone! I find that a significant source of confusion around
sst
, when I’ve introduced it to others, is the lack of clarity between Serverless-Stack, the platform/framework (I’ll refer to as
sst
), and the Serverless-Stack Guides, which I assume pre-dates sst. It’s jarring because the branding between SST and the guides are, presumably, one in the same. But they seem to be positioned as guides for building sst apps, though there’s a large number of non-sst articles. For someone without extensive Serverless Framework experience, and a bit of sst experience, it can be very confusing when building a new stack. It seems odd that there are non sst articles that are seemingly promoted as sst guides, but most importantly, there’s almost no context to what the guides are promoting. The recent reorganization of the articles help, but it’s still confusing. I bring this up because I’m curious if this has been discussed / mentioned, is it being actively considered, and could you use help with this? I’m a big fan of sst, and I would be happy to apply my experience in branding, optimizing user-experience, etc. But I want to know if this resonates with anyone else, whether or not I can be of any help, and whether I’m missing any information. Thanks all!
r
It was discussed a little while back with @Jay. I found the same when I first started using SST because the documentation that was front and centre on the website was the excellent serverless framework guide. I know some work was done to refocus the website on SST, but now that I’ve been using SST for a while, I know exactly where to go to find what I need in the docs and so don’t experience the website as a first time user.
j
Yeah we’ll prioritize this internally to fix this soon. @Frank let's talk about it this weekend?
a
Just get rid of SLS. 😂
j
Yeah we’ll move it out of the guide most likely.
f
Sounds good, let’s talk about this today
j
Just an update folks, we’ll be working on it this week.
d
🙏
Any luck on this?
f
Hey @Dave Arel, yeah we are making some changes to only keep SST related chapters in the guide, and also tying in the SST console to help ppl manage their resources without having to learn the AWS console. @Jay can share more details on the progress.
j
Yeah we couldn't get it done last week but we are going to be working on it. Just curious if there's a reason why you are waiting for it?
d
Advocating for SST, and the guides have been a significant source of confusion. I’m not waiting for it, per say. It’s not like a blocking feature of course haha, I just think it would help add clarity.
j
Yeah that makes sense. It’s something we are working on.