Comments (6)
hi @hassila, in my opinion (not representing the rest of the SSWG), I think adding such getting started guide is great and within the goals for these guide, they should serve both new users that just want to get started as well as more advanced topics like performance troubleshooting, etc.
when it comes to #27, I feel that one is less "in scope" given that the SSWG is also an incubator for tools and libraries and already publishes a list of libraries that are going through incubation process in https://swift.org/server#projects. in other words having two lists with different sets of libraries, and no clear criteria for inclusion in the "frameworks" list could become confusing for users and challenging from a governance point of view.
what I can suggest is working with the folks behind swiftpackageindex.com to see if they have some "tag" or other search criteria for server packages and add links in these guides to teach folks where to find libraries/tools/packages for swift on server. this democratizes the process, since any framework author can publish their package into that index and tag it accordingly to show up in the search results. cc @daveverwer @finestructure
@swift-server/sswg wdyt?
from guides.
what I can suggest is working with the folks behind swiftpackageindex.com to see if they have some "tag" or other search criteria for server packages and add links in these guides to teach folks where to find libraries/tools/packages for swift on server. this democratizes the process, since any framework author can publish their package into that index and tag it accordingly to show up in the search results. cc @daveverwer @finestructure
We're just wrapping up a couple of final features before announcing what we'll be working on next, but it's very likely that adding categories/tags to package metadata will feature prominently in our next set of features we add.
Thanks @daveverwer - don't hesitate to reach out if you want a sounding board.
from guides.
@hassila your work on this topic is very valuable! once we have the content well organized we can figure out how to best make it discoverable via swift.org, the swift forums and/or other potential places
from guides.
Thanks @tomerd , my question was more along the lines whether there would be friction if adding more fundamental starting docs if its not purely in the SSWG related domain (e.g. like in #27).
I think its good to just scope what should be here and personally I think it would make sense to have all the needed starting points for a new potential server-side developer to get started.
I mean, like that forum post, it shouldn't be like that - a reasonable experienced developer should be able to take the documentation and run with it to get an initial environment up and running and "hello world" up as well as more advanced topics.
So basically I just wanted to verify that the maintainers agreed with that scope.
from guides.
Sounds reasonable, will see what comes out from SPI, I think swift package index could play a role there as you suggest, the friction to get started with swift on the server needs to be smoothed out to reach a broader audience I think.
from guides.
what I can suggest is working with the folks behind swiftpackageindex.com to see if they have some "tag" or other search criteria for server packages and add links in these guides to teach folks where to find libraries/tools/packages for swift on server. this democratizes the process, since any framework author can publish their package into that index and tag it accordingly to show up in the search results. cc @daveverwer @finestructure
We're just wrapping up a couple of final features before announcing what we'll be working on next, but it's very likely that adding categories/tags to package metadata will feature prominently in our next set of features we add.
from guides.
Related Issues (20)
- document deployment to Azure
- Optimizing binary size, for small runtimes (lambda etc)
- document architecture of swift based [iOS, macOS] client > server system HOT 1
- Document memory usage testing, could point to NIO's tools
- Document setting up Swift plugins in IDEs (Atom etc)
- swift library author guide HOT 2
- guide for wrapping C APIs HOT 2
- guide around crypto and security
- guide for writing high performance systems in swift HOT 1
- swift service developer guide HOT 1
- How to approach Issues in this repository
- Document using Swift with VSCode HOT 6
- Guides like the Ubuntu guide recommend installing Swift 5.2
- Document deploying to ECS
- Document deploying to EKS
- Document deploying to AWS App Runner
- Document setting up deployments with AWS Copilot
- Document proxy usage with Envoy
- Document using AWS App Mesh and Cloud Map for service-to-service communication
- Document deploying to AWS Lambda
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
š Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ššš
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ā¤ļø Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from guides.